ВВЕДЕНИЕ 


В.1. Дисциплина программной инженерии 


Разработка программ, как и многие другие виды деятельности человека, 
может производиться различными способами. Как ремесленник, использующий 
минимальный набор ручного инструмента, создаёт штучные изделия народного 
промысла, так и индивидуальный разработчик может воплощать свои идеи в 
программном продукте, используя лишь текстовый редактор и компилятор. 

Но как современный мир был бы невозможен без массового промышлен- 
ного производства, которое осуществляется на фабриках и заводах большими 
коллективами согласованно действующих людей с использованием разнообраз- 
ных машин и механизмов, точно так же невозможна качественная реализация 
больших программных систем без применения специальных инструментов, 
следования установленным правилам организации рабочего процесса и взаимо- 
действия участников проекта. В результате научных исследований, многочис- 
ленных проб и ошибок были выработаны приёмы разработки программ, позво- 
ляющие с высокой степенью вероятности гарантировать получение качествен- 
ного программного продукта, отвечающего требованиям заказчиков, — сфор- 
мировалась дисциплина программной инженерии. 

Чтобы занять своё место в команде, программисту уже недостаточно 
знать методы алгоритмизации и язык программирования. Он должен владеть 
инструментарием, который используют участники команды для совместной ра- 
боты над проектом. В число необходимых инструментов входит среда разработ- 
ки (включающая редактор исходных текстов, компилятор, компоновщик и от- 
ладчик) и система контроля версий. Зачастую используются дополнительные 
инструменты — системы учёта заявок на доработку, автоматизированного те- 
стирования, доставки и развёртывания программной системы на целевой плат- 
форме, где осуществляется её промышленная эксплуатация. 

Эти актуальные требования к квалификации ИТ-специалистов нашли от- 
ражение в федеральных государственных образовательных стандартах (ФГОС) 
среднего профессионального (СПО) и высшего образования (ВО): 

ФГОС СПО 09.02.03 — Программирование в компьютерных системах; 

ФГОС ВО 09.03.02 — Информационные системы и технологии; 

ФГОС ВО 09.03.04 — Программная инженерия. 

В частности, в рамках междисциплинарного курса МДК 03.02 «Инстру- 
ментальные средства разработки программного обеспечения» предъявляются 
требования к знанию учащимися структур и приёмов работы с инструменталь- 
ными средствами, поддерживающими создание программного обеспечения, по- 
ниманию методов организации работы в коллективах разработчиков программ- 
ного обеспечения. Студенты, осваивающие программу бакалавриата, должны 
научиться организовывать работу малых коллективов исполнителей, применять 
при решении задач профессиональной деятельности современные информаци- 
онные технологии и программные средства, инсталлировать программное обес- 


печение для информационных и автоматизированных систем. Программами 
ПОДГОТОВКИ ИТ-специалистов предусмотрены лабораторные работы, производ- 
ственная и преддипломная практики для получения практических навыков ис- 
пользования инструментальных средств разработки программного обеспечения. 


В.2. Инструменты системы Ро$$1 


Эта книга посвящена бесплатному свободно распространяемому интегри- 
рованному программному продукту Е0$51 (6 р://0$$1-5стп.оте), который реали- 
зует сразу пять инструментов, необходимых в коллективной работе над проек- 
тами: систему контроля версий (аналог С), систему учёта заявок (аналог Лга), 
систему документирования (аналог \71К1), форум и статический веб-сервер. Не- 
которым пользователям не хватает терпения разобраться со всеми возможно- 
стями и особенностями применения системы Е 0351, но тех, кто преодолел пер- 
вые трудности, она покоряет своей простотой и изяществом архитектуры. 

Будучи задуманной в качестве системы контроля версий для поддержки 
процесса разработки системы управления базами данных ЗОГе, система Ео$$П 
постепенно обрастала дополнительными подсистемами, которые способствова- 
ли улучшению процесса совместной работы, но которые базировались на одном 
и том же механизме хранения версионированной информации. В результате по- 
лучился компактный набор инструментов, заключённый в одном-единственном 
исполняемом файле, который легко устанавливать и эксплуатировать. Благодаря 
этому на её основе могут быть развёрнуты учебные стенды для проведения 
практических и лабораторных работ по использованию систем контроля версий 
и систем управления заявками. 

Система Ео5$П достаточно стабильна для промышленного применения. 
Однако, несмотря на то, что в переводе с английского слово №0551 означает ис- 
копаемое и окаменелость, она продолжает динамично развиваться. Инструмен- 
ты, входящие в состав этой системы, могут быть использованы студентами при 
выполнении курсовых и дипломных проектов, при прохождении производ- 
ственных практик, а специалистами — в их профессиональной деятельности. 

Возвращаясь к высказанной аналогии между ремесленниками и индиви- 
дуальными разработчиками, можно отметить, что в современном мире даже ма- 
стера народных промыслов предпочитают использовать усовершенствованные 
инструменты с электрическим приводом. Поэтому программистам, которые за- 
нимаются разработкой программных продуктов единолично, стоит присмот- 
реться к инструментам Е0$$Й и воспользоваться ими для улучшения организа- 
ции своей деятельности. 

Система Е0о$5П представляет интерес не только как набор инструментов, 
но и как самостоятельный объект изучения. Она реализована командой высоко- 
квалифицированных разработчиков, которая занимается развитием проекта 
ЗОГще, на языке программирования Си, соответствующем стандарту С89. Си- 
стема имеет ясную архитектуру, что позволяет студентам вносить изменения в 
исходные тексты, собирать из них исполняемые файлы и непосредственно 
наблюдать результат своих действий. В системе Е0$51 реализован режим работы 
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с базой данных репозитория на низком уровне, что позволяет использовать язык 
запросов ЗОГ, для изучения структуры репозитория. С помощью системы Е0$$ 
можно без погружения в сложное конфигурирование наглядно продемонстри- 
ровать работу веб-сервера. 

Некоторые современные книги содержат многочисленные ссылки на до- 
полнительные материалы, размещённые в сети Интернет. По мнению автора, 
книга — не самый лучший способ хранения интернет-закладок. Поэтому, в от- 
личие от них, эта книга самодостаточна. В ней имеются все необходимые иллю- 
страции, полностью приводятся интерактивные диалоги между пользователем и 
системой Е0$5П в режиме командной строки. Книгу можно читать вообще без 
компьютера, и это не должно затруднить усвоение материала. К практическим 
упражнениям можно переходить после заочного знакомства с системой. Един- 
ственный необходимый веб-ресурс, который упоминается в книге, — это офи- 
циальный веб-сайт системы Ео53$1, на котором можно получить актуальные вер- 
сии дистрибутивов системы для различных операционных систем. 

В связи с отсутствием устоявшейся русскоязычной терминологии в обла- 
сти систем контроля версий при написании книги большое внимание уделялось 
составлению тематического словаря (результат этой работы можно увидеть в 
глоссарии, который приведён в приложении). 


Глава 1 . 
ЭВОЛЮЦИЯ СИСТЕМ КОНТРОЛЯ ВЕРСИИ 


1.1. Важность хранения истории изменений 


Начнём эту книгу с диалога, который вполне мог бы произойти. 

— Представляешь, я потерял все свои наработки... 

— Как это могло случиться?! Разве ты не делал резервные копии? 

— Конечно, делал! Кроме файла на ноутбуке, у меня были его копии на 
флешке и в облачном хранилище. 

— Что же тогда произошло? 

— Понимаешь, в конце работы я решил подсчитать количество слов в до- 
кументе. Выделил весь текст, увидел то, что мне было нужно, а потом, перед 
сохранением, наверное, нечаянно нажал какую-то клавишу — и выделенный 
текст пропал. Я этого не заметил и переписал эту копию и на флешку, и в хра- 
нилище. А сегодня утром смотрю — везде пустые файлы... 

Действительно, одно только наличие резервных копий рабочих файлов не 
может гарантировать сохранность находящейся в них информации. Повредится 
эталон, не важно, в результате ошибочных действий или технического сбоя, — 
и битая копия затрёт результаты работы на резервных носителях. 

Не удивительно, что люди стали искать способ решения этой потенциаль- 
ной проблемы и придумали для этого множество способов. Одним из лучших 
решений для предотвращения утраты результатов труда является использование 
специального инструмента — системы контроля версий, которая не заменяет 
старые варианты файлов новыми, а хранит всю историю их изменений. 

Если использовать не локальную, а распределённую сетевую систему 
контроля версий, то история работы будет храниться на нескольких компьюте- 
рах, что практически исключит риски, о которых шла речь в начале этого разде- 
ла. Эта книга посвящена одному из таких инструментов — распределённой си- 
стеме контроля версий Е0о$51. 

Кому может понадобиться система контроля версий? Если ответить на 
этот вопрос кратко, то всем, чья работа с компьютером заключается во внесении 
накапливающихся изменений в различные файлы до тех пор, пока не будет ре- 
шена поставленная задача. 

В эту категорию, прежде всего, попадают программисты и веб-разработ- 
чики. Их деятельность напрямую связана с написанием исходных текстов про- 
грамм и веб-страниц. Они начинают с пустого текстового файла и постепенно 
заполняют его фразами на языке разработки, периодически оценивая промежу- 
точные результаты. Если промежуточный результат соответствует ожидаемому, 
то проект продолжают развивать от достигнутого. В противном случае в теку- 
щие файлы вносят изменения, пока результат не станет соответствовать проме- 
жуточной цели. 

Похожую методику используют писатели, работая над художественным 
произведением. Они последовательно развивают сюжетные линии своего рома- 
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на, но в процессе творческого поиска иногда заходят в тупик и, чтобы выбрать- 
ся из него, возвращаются к одному из предыдущих вариантов черновика. 

Юристы коммерческих и государственных структур, работая над проек- 
тами контрактов, распоряжений, приказов, постановлений, нормативных актов, 
законов обычно начинают с утверждённого шаблона. В ходе доработки доку- 
мент проходит многочисленные согласования, в результате которых возникают 
поправки и корректировки. Этот процесс продолжается до получения оконча- 
тельного варианта и его утверждения. 

Системные администраторы и администраторы программных комплексов 
регулярно вносят изменения в конфигурационные файлы. Внедрив систему 
контроля версий, они прежде всего получат автоматически ведущийся журнал, с 
помощью которого не составит труда установить, какое изменение привело к 
возникновению проблем, а также когда, кем и почему оно было выполнено. По- 
мимо электронного журнала у них появится возможность мгновенно восстано- 
вить одно из сохранённых состояний администрируемой системы. 

Перечень специалистов, работа которых ведётся по аналогичным схемам, 
можно дополнить инженерами-конструкторами и проектировщиками, музыкан- 
тами и художниками, которые используют в своей профессиональной деятель- 
ности компьютер. Но убедить использовать новый инструмент профессионалов, 
которые много лет выполняют свою работу по сложившейся методике, непро- 
сто. Тем более если работа с ним требует обучения и привыкания, нарушает 
привычный ритм и последовательность операций. 

Замечено, что улучшения рабочего процесса обычно дают положитель- 
ный эффект по прошествии некоторого времени, а в ближайшей перспективе, 
наоборот, приводят к уменьшению производительности труда. Стоят ли усилия, 
которые необходимо приложить для внедрения нового инструмента, тех резуль- 
татов, которые будут получены? Чтобы это оценить и лучше понять, какие про- 
блемы и каким образом решают системы контроля версий, надо проследить ис- 
торию их появления и развития. Но сначала рассмотрим типичные приёмы, ко- 
торые применяются в работе с файлами без использования этих систем и кото- 
рые базируются на здравом смысле и подручных средствах. 


1.2. Здравый смысл и подручные средства 


Как работает программист, который не использует систему контроля вер- 
сий? Основной инструмент программиста — текстовый редактор, и работу над 
проектом он начинает с создания текстового файла, в который записывает фра- 
зы на языке программирования проекта. Перед этим, конечно, программист со- 
здал отдельный каталог для хранения файлов с исходными текстами програм- 
мы. В дальнейшем этот каталог будем называть рабочим каталогом проекта. 

Сначала работа продвигается бодро: каркас большинства программ вы- 
глядит одинаково, пальцы сами набирают хорошо известные конструкции. Че- 
рез непродолжительное время вызывающая программа готова, прошла тестиро- 
вание и полностью удовлетворяет программиста. 


Опытный программист предпочитает фиксировать варианты исходных 
текстов, из которых собирается приемлемая на определённом этапе программа. 
Поэтому сейчас он сохраняет исходные тексты из рабочего каталога в другом 
каталоге, например с именем УЕВО01. Понимая, что уже через час он не вспом- 
нит, какой стадии проекта соответствует содержимое этого каталога, програм- 
мист создаёт в рабочем каталоге проекта текстовый файл В $югулх{ и вписывает 
в него первую строку: 


11:18 09.03.2020 \УЕВО01 Каркас приложения. 


По мере реализации различных функций программы на диске появляются 
каталоги \/ЕВ002, /ЕРООЗ, ..., \ЕРО12, а текстовый файл югу { дополняется 
строками: 


18:03 16.02.2020 \ЕВ012 Исправлена ошибка выхода за границы масси- 
ва при вычислении медианы. 


09:20 10.02.2020 УЕВО0З Реализованы действия, соответствующие под- 
унктам меню Настройки. 
16:31 09.02.2020 \УЕВО02 Реализованы действия, соответствующие под- 
унктам меню Файл. 

11:18 06.02.2020 \УЕВО01 Каркас приложения. 


На каком-то этапе программист понимает, что при реализации очередной 
функции зашёл в тупик. И гораздо легче вернуться назад на несколько шагов к 
сохранённому варианту, чтобы продолжить развитие проекта в другом направ- 
лении, чем исправлять нагромождение созданного с того времени кода. 

Казалось бы, нет ничего проще — переписать содержимое требуемого 
УЕК-каталога в рабочий каталог и работать как ни в чём не бывало. Но, с дру- 
гой стороны, может быть, всё не так страшно, как кажется в данный момент? До 
попадания в тупиковую ситуацию было реализовано несколько интересных ал- 
горитмов, которые могли бы быть полезны в дальнейшей работе, и не хотелось 
бы их потерять при откате к предыдущей версии. 

Поэтому программист решает сохранить текущее, пусть и представляю- 
щееся сейчас бесперспективным, состояние проекта. Для этого он создаёт ката- 
лог ВАО001, копирует туда файлы с исходными текстами из рабочего каталога и 
вносит запись в югу. 4х: 

12:05 28.02.2020 ВАРО01 Тупик при реализации обхода дерева клиен- 


тов - откат к \ЕВ0О26. Эффективно реализована группировка по воз- 
растным группам. 


Теперь кроме резервных копий успешно реализованных этапов проекта в 
каталогах /ЕР### начинает выстраиваться линейка тупиковых вариантов в ка- 
талогах ВАО##Я. И это не зря, потому что даже в показавшемся сначала беспер- 
спективным варианте после испытания альтернативных решений может обна- 
ружиться рациональное зерно. 

Иногда способ реализации очередной функции программы не очевиден 
или у программиста имеется несколько идей, из которых на данном этапе раз- 
вития проекта он не готов выбрать лучшую без предварительной апробации. 


В этом случае программист создаёт каталог ТЕЗТ и делает в нём предваритель- 
ный набросок одного из возможных вариантов. Может быть, он создаст не- 
сколько каталогов: ТЕЗТ1, ТЕЗТ2, ТЕЗТЗ, — чтобы проверить свои идеи. Потом, 
выбрав из вариантов наилучший, перепишет соответствующие ему исходные 
тексты в рабочий каталог и продолжит разработку. 

Так, шаг за шагом, в конце концов этот проект будет реализован. Огляды- 
ваясь назад, можно отметить основные организационные мероприятия, которые 
ему сопутствовали: 

® создание мгновенных снимков рабочего каталога для использования в 
качестве резервных копий; 

® аннотирование созданных мгновенных снимков краткими описаниями 
для того, чтобы в дальнейшем можно было найти требуемую точку сохранения; 

® периодические возвраты к точкам сохранения; 

® создание ответвлений в развитии проекта для тестирования различных 
вариантов решения задачи. 

Все перечисленные организационные задачи программист решал сред- 
ствами операционной системы, используя в качестве базы данных иерархиче- 
скую файловую систему. 

В рассмотренном примере программист разрабатывал программу едино- 
лично. На сегодняшний день такие случаи скорее исключение, чем правило. 
Даже в организациях, где создание программного продукта не является основ- 
ным видом деятельности, над сопровождением эксплуатирующихся программ 
трудятся несколько человек, которые должны иметь одинаковые права на до- 
ступ к их исходным текстам и файлам конфигурации. 

Коллективная работа над проектом вносит дополнительные трудности. 
Индивидуальность отдельных участников может проявиться самым непредска- 
зуемым образом, различия в представлениях о лучшем способе решения задачи 
могут приводить к конфликтам в самых сплочённых группах. 

Нельзя исключать ситуации, когда двум различным участникам проекта 
одновременно потребуется внести изменения в исходные тексты функций, 
находящихся в одном файле. В этом случае зафиксируется результат того спе- 
циалиста, который сохранит свой вариант файла последним, а работа другого 
участника при этом будет утеряна. 

Организационные меры в виде списка правил, которым должны следовать 
все участники, не всегда способны исправить ситуацию. Не удивительно, что 
начали проводиться исследования в поиске технических средств для улучшения 
процесса работы над проектом. 


1.3. Локальные системы контроля версий 


Первой системой контроля версий, получившей признание, стала система 
контроля исходных текстов $СС$ (Зоигсе Соде Сопёо] Зузет). Она была раз- 
работана в Ве| Габогафотез и реализована на компьютерах 1ВМ 370 и РПР 11, 
о чём сообщил в 1975 г. Марк Дж. Рочкинд (Магс У. КосЬК1т9). 


В то время уже реализовывались масштабные программные проекты, и их 
разработчики постоянно сталкивались с одними и теми же проблемами. Во- 
первых, имелась сложность восстановления истории модификаций исходных 
текстов программ. Очевидно, что если в какой-то момент разрабатываемая про- 
грамма перестаёт работать так, как ожидается, то это происходит из-за каких-то 
изменений. Для быстрого решения подобных проблем важно знать, кем, когда, 
где и для чего были внесены эти изменения. 

Во-вторых, лавинообразно возрастал объём дискового пространства, не- 
обходимый для хранения исходных текстов программ. Для каждого значитель- 
ного изменения при выпуске новой версии продукта создавалась полная копия 
файлов рабочего каталога. Если для какого-то клиента требовалась специфиче- 
ская функциональность, которую невозможно отразить с помощью имеющихся 
в программе настроек, то специально для него создавалась отдельная ветвь раз- 
работки. При этом различия между копиями исходных текстов были крайне ма- 
лы по сравнению с их размерами, что позволяло судить о неэффективном рас- 
ходовании памяти. 

Система контроля исходных текстов 5СС$ решала обе эти проблемы. 
Контролируемые ею файлы были представлены последовательностью всех от- 
дельных изменений, называемых дельтами, которые произошли с момента со- 
здания вплоть до актуального состояния. Чтобы получить файл в его текущем 
состоянии, надо пройти по всей последовательности, применяя имеющиеся в 
ней изменения. Если этот процесс остановить в промежуточной точке, то будет 
получена одна из предыдущих версий файла. 

На этой последовательности особо отмечаются точки, в которых изменя- 
ется версия программы. К этим и только к этим точкам программист впослед- 
ствии может дописывать изменения, исправляющие обнаруженные ошибки. 
Изменения, выполненные в рамках «работы над ошибками», учитываются 
только при извлечении исходного текста интересующей версии, но исключа- 
ются из прямой цепочки изменений, ведущей к актуальному состоянию файла 
(рис. 1.1). 

При использовании системы $СС$ доступ к файлам с исходными текста- 
ми полностью контролируется этой системой. Для того, чтобы доработать необ- 
ходимый файл, программист должен сначала запросить его у системы, затем 
внести необходимые изменения, после чего вернуть его в систему, сопроводив 
описанием проделанной работы. Система автоматически определяет различия 
между предыдущим и новым вариантами файла и сохраняет их в виде дельты, 
снабжая отметкой времени модификации, номером версии и именем автора из- 
менений. 

К началу 1980-х гг. сформировались современные теоретические основы 
систем контроля версий. История изменений объекта контроля представляется в 
виде направленного ацикличного графа (@тесе4 асусПс этарв, РАС), вершины 
которого соответствуют промежуточным состояниям объекта (рис. 1.2). 
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Рис. 1.1 


Хранение файла в виде последовательности изменений: начиная с пустого файла 
в результате трёх шагов получена первая версия программы 11. Дополнительный шаг 
разработки относится ко второй версии И2. Для исправления ошибки, обнаруженной 
в версии 1, был выполнен четвёртый шаг, относящийся только к этой версии 
и не влияющий на версию Г2. При необходимости в версии Г? надо произвести 
аналогичные изменения 


Рис. 1.2 


Направленный ацикличный граф истории изменений объекта. В вершинах 2 и 3 произведены 
ответвления от основной линии, которые затем вливаются в неё в вершинах 5 и 6 


И 


В 1982 г. Уолтер Ф. Тичи (\Ма[ег Е. Певу) написал статью «Проектирова- 
ние, реализация и исследование системы контроля изменений» о разработанном 
в американском университете Пердью (Ригдие Отуегзиу) программном продук- 
те КС$ (Ве\у1хюп Сопио! зузет). Этот продукт, состоящий в соответствии с 
идеологией МХ из нескольких простых утилит, позволяет: 

® помещать файл в его текущем состоянии в хранилище, снабжая его от- 
меткой времени, номером версии, информацией об авторе и кратким описанием 
произведенных изменений; 

® извлекать файл требуемой версии из хранилища для просмотра или 
внесения изменений; 

® создавать ответвление от генеральной линии разработки для исправле- 
ния ошибок или апробирования новаторских идей; 

® внедрять изменения, произведенные в ответвлениях, в основную ветвь 
разработки; 

® просматривать историю изменений. 

Особой гордостью разработчиков стала эффективная реализация хране- 
ния версий текстовых файлов — отдельными ретроспективными блоками отли- 
чий (теуегзе зерагае 4е!аз), что увеличивает скорость работы системы при не- 
значительном увеличении объема памяти, необходимой для хранения истории 
изменений. Этот подход основан на том факте, что последние версии файлов 
требуются гораздо чаще, чем предыдущие. Поэтому с точки зрения производи- 
тельности выгоднее хранить актуальные варианты файлов в явном виде, а 
предыдущие версии получать путём применения к ним обратных изменений. 

В системе ВС$ используется уже привычная терминология: 

® спесК-ш — запись в хранилище; 

® спеск-ойЕ — извлечение из хранилища; 

® ЮЩи бтапсЬ — разветвление и ответвление; 

® тегое — слияние. 

В локальных системах контроля версий основным методом решения по- 
тенциального конфликта изменений, одновременно внесённых разными разра- 
ботчиками в один и тот же файл, является его предотвращение с помощью ме- 
ханизма блокировок. То есть файл, взятый из системы контроля версий для мо- 
дификации одним из участников проекта, становится недоступным для осталь- 
ных членов команды до тех пор, пока он не будет возвращён обратно в систему. 


1.4. Централизованные системы контроля версий 


Локальные системы контроля версий, рассмотренные выше, помогают ор- 
ганизовать работу специалиста, единолично решающего поставленную перед 
ним задачу, или коллектива сотрудников, использующих общее файловое хра- 
нилище. Последний вариант был актуален в период превалирования больших и 
малых ЭВМ, которые являлись ядром вычислительного комплекса и центром 
хранения и обработки данных. Коллективный доступ для пользователей к таким 
ЭВМ обеспечивался посредством дисплейных терминалов. 
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С распространением в начале 1980-х гг. персональных компьютеров 
наблюдаются две тенденции. С одной стороны, каждый пользователь становит- 
ся обладателем вычислительных ресурсов, достаточных для автономной рабо- 
ты. Теперь не требуется записываться в график использования машинного вре- 
мени и идти на работу в дисплейный зал. С другой стороны, решаемые задачи 
требуют взаимодействия с такими же автономными единицами и регулярного 
обмена своими наработками. 

Набирает популярность идея объединения персональных компьютеров в 
вычислительные сети, но постоянное подключение скорее является исключени- 
ем, чем правилом. В большинстве случаев работа в сети происходит короткими 
сеансами, для чего пользователь подключается к ней с помощью модема через 
обычную телефонную линию. Распространённым средством хранения и пере- 
носа информации является гибкий магнитный диск. 

В ‘таких условиях родилась система параллельных версий С\УЗ 
(СопситепЕ Уегз1оп$ Зузет), которую Дик Грюн (Оаск Огипе), доктор наук Ам- 
стердамского свободного университета, в своей статье назвал способом незави- 
симого сотрудничества. Эта система являлась надстройкой над системой ВС и 
представляла собой набор из 25 сценариев оболочки УМХ. Она была успешно 
использована в проекте распределённой разработки компилятора АСК 
(Атзуегаат СотшрИег К). 

При разработке системы СУЗ основное внимание уделялось решению 
проблемы одновременной модификации одного и того же файла разными поль- 
зователями — конфликта изменений. Для этого была введена абстракция репо- 
зитория — единого хранилища всех версий файлов проекта. Доступ к этому 
хранилищу осуществлялся посредством набора специальных утилит. 

Работа над проектом с точки зрения системы СУ$ заключается в перио- 
дическом выполнении двух основных операций: 

® получение из репозитория изменений, выполненных другими участни- 
ками проекта, и наложение их на свои экземпляры файлов; 

® передача в общий репозиторий своих собственных изменений (для этой 
операции вводится термин сот). 

Главное достоинство такой схемы в том, что она позволяет своевременно 
обнаружить конфликт изменений (рис. 1.3). 

Ориентация не на предотвращение конфликтов путём блокировки нахо- 
дящихся в работе файлов, как это было сделано в локальных системах контроля 
версий, а на их раннее обнаружение и устранение дала возможность применять 
СУБ в распределённой разработке. В ходе работы у каждого участника проекта 
хранится своя локальная копия необходимых ему файлов. Эти файлы можно 
модифицировать автономно, без постоянного сетевого подключения. По мере 
готовности произведенные в файлах изменения передаются в общий репозито- 
рий, по сети или на машинном носителе информации. В этот момент осуществ- 
ляется их проверка на наличие конфликта с изменениями, произведенными дру- 
гими сотрудниками. Если обнаружен конфликт, то предлагается его устранить, 
после чего процедура повторяется. 
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Разработчик 1 


Разработчик 2 


Рис. 1.3 
Два разработчика получают из репозитория исходный вариант файлов проекта А, 
вносят каждый свои изменения О1 и 02, после чего передают их обратно в репозиторий. 
Результатом наложения изменений является вариант А12. Но изменения могут поступить 
в другом порядке: сначала 02, а потом О1, в результате чего получится вариант А21. 

Если А12 отличается от А21, то изменения 01 и 22 конфликтуют между собой 

Подход, реализованный в С\УЪЗ, оказался настолько удачным, что эта си- 
стема контроля версий стала стандартом де-факто в сфере разработки про- 
граммного обеспечения и применялась во множестве проектов вплоть до конца 
ХХ в. А тем временем развивались сетевые технологии, в начале 1990-х гг. по- 
явилась всемирная паутина. Компьютеризация уверенно вышла за рамки уни- 
верситетов и специализированных учреждений, охватила все сферы жизни. 

Стремительными темпами растёт число компаний, предоставляющих ИТ- 
услуги. Разработка программ приобретает глобальный характер, набирает силу 
движение Ореп Зоигсе, локомотивом которого становится операционная систе- 
ма Глиих. Наряду с ростом сложности программ возрастают требования к их 
надёжности. Для повышения их качества проводятся мероприятия по улучше- 
нию процесса разработки, внедряются системы управления заявками на дора- 
ботку, системы автоматизации сборки и тестирования. 

В конце 1990-х гг. приходит понимание, что необходим перевод удачных 
идей, реализованных в С\У$, на новую технологическую платформу. Заказ на 
решение этой задачи поступил от производителя систем для совместной работы 
СоПабМ№е в начале 2000-х гг. Целью проекта, который получил название 
Зибуег$1оп (иногда используется сокращение ЗУМ), была не разработка рево- 
люционной системы контроля версий, а решение проблем, которые выявились в 
СУ\У$ за годы промышленной эксплуатации и в современном программном 
окружении. Уже к сентябрю 2001 г. степень готовности системы ЗиБуегз1оп до- 
стигла такого уровня, который позволил ей вести её же собственный репозито- 
рий (до этого разработчиками использовалась С\У5). 
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Ключевыми отличиями Зибуезтоп от СУБ стали: 

® ведение контроля не только над файлами, но и над каталогами; 

® атомарность (транзакционность) операции записи в репозиторий сово- 
купности изменений, выполненных в различных файлах проекта; 

® использование алгоритма определения различий на двоичном уровне, а 
не на уровне строк текстов; 

® открытая архитектура, обеспеченная реализацией АР] (интерфейса про- 
граммного взаимодействия). 

Благодаря модульной архитектуре (рис. 1.4) ядро системы контроля вер- 
сий Зибуег$1оп может: 

® использовать различные хранилища для репозитория — систему управ- 
ления базами данных или традиционную файловую систему; 

® управляться со стороны клиентов различными способами — локально 
из командной строки или через сеть по протоколам НТТР или 5ЗН. 
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Рис. 1.4 
В модульной архитектуре 5ибБуегяоп ядро системы контроля версий (СКВ) 
отделено от хранилища репозитория и клиентов 
Такая открытая реализация системы контроля версий позволяет использо- 
вать еб в составе интегрированных программных систем для коллективной ра- 
боты, включающих в себя разнообразные инструменты. 


1.5. Распределённые системы контроля версий 


В 2005 г. на арену выходит одна из самых популярных на сегодняшний 
день систем контроля версий — Си. Основное её отличие от системы 
Зибуег$1оп в том, что она является не централизованной, а распределённой. 
В системе баБуег1юоп полная история изменений всех файлов проекта хранится 
только в одном месте — в центральном репозитории, а у участников проекта 
находятся лишь рабочие копии файлов. 

Система С работает иначе: копию репозитория проекта получает каж- 
дый участник. Коллективное взаимодействие может строиться по различным 
схемам — либо с выделенным сервером, что будет напоминать централизован- 
ную модель, либо через распределённую систему репозиториев, организован- 
ную с учётом ролей участников проекта. Последний вариант реализован в по- 
пулярных сервисах СИНи6 и СИГаь (рис. 1.5). 
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Официальный Репозиторий Репозиторий 
репозиторий участника участника 


Интегратор Участник Участник 


Рис. 1.5 
Разработка с распределёиной системой контроля версий. Каждый участник работает 
со своей копией официального репозитория, а интегратор проекта внедряет выполненные 
ими изменения в официальный репозиторий 

Ещё одним отличием СИ от ранее рассмотренных систем контроля версий 
является модель репозитория. Если предшественники смотрели на репозиторий 
как хранилище истории изменений, выполненных в файлах, то Ой трактует ре- 
позиторий как виртуальную файловую систему, хранящую снимки рабочего ка- 
талога в определённые моменты времени. 

Помимо прочего, распределённая архитектура увеличивает скорость вы- 
полнения основных операций, в частности помещение моментального снимка 
рабочего каталога в репозиторий. Если в централизованных системах для этого 
требуется сетевое подключение, то в Ой такая операция выполняется над ло- 
кальным хранилищем. Синхронизация локального хранилища с сетевым репо- 
зиторием сервера — это отдельная фаза использования системы. 

Будучи изначально спроектированной для поддержки процесса разработ- 
ки ядра операционной системы Глпих, система СЁ хорошо подходит для исполь- 
зования в крупных распределённых проектах, хотя пригодна и для локальной 
разработки. 


1.6. О выборе системы контроля версий 


Изложенная крагкая история развития систем контроля версий иллюстри- 
рует эволюцию представлений о том, как средства автоматизации должны спо- 
собствовать разработке проектов, в основе которых лежит изменение файлов. 
Может сложиться впечатление, что на каждом этапе новые системы заменяли 
своих предшественников, которые безнадёжно устарели. На самом деле это не 
совсем верно. 

История развития вычислительной техники демонстрирует постоянное 
расширение круга решаемых с помощью компьютеров задач. Сначала это были 
задачи научных вычислений, затем хозяйственно-экономических расчётов, хра- 
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нения и обработки алфавитно-цифровой информации, контроля технологиче- 
ского оборудования и управления производственными процессами. Возможно- 
сти современной вычислительной техники позволяют выполнять обработку 
мультимедийных данных в реальном времени, обеспечивают их оперативную 
передачу и хранение. Это привело к созданию на её основе принципиально но- 
вых средств общения. 

Но с компьютеризацией новых сфер жизни людей старые задачи не исче- 
зают — по-прежнему существует необходимость и в научных вычислениях, и в 
автоматизации бухгалтерского учёта. И средства, которыми решались эти зада- 
чи раньше, даже с позиции современности оказались не так уж плохи. Об этом, 
к примеру, свидетельствует спрос на специалистов, владеющих языком про- 
граммирования СОВОГ, для сопровождения функционирующих систем автома- 
тизации предприятий. 

Системы контроля версий сопровождают развитие вычислительной тех- 
ники и расширение сферы её применения. Все описанные системы были пред- 
назначены для решения конкретных задач в определённых условиях, и нельзя 
сказать, что одна из них определённо лучше других. При выборе системы кон- 
троля версий для конкретного проекта надо ориентироваться на его специфиче- 
ские требования. 

Например, для индивидуальной разработки даже в современных условиях 
вполне может подойти система КС$, последняя версия 5.9.4 которой вышла в 
2015 г. И уж точно не стоит списывать со счетов систему Зибуегз!оп, которая 
находится в активной разработке под эгидой АрасВе ЗоЙу\угаге Еоипданоп и не- 
давно отметила своё двадцатилетие. 

При выборе системы контроля версий для практического применения на 
первый план могут выйти критерии, о которых ещё не было сказано. Например, 
в настоящее время нередки случаи, когда коммерческой разработкой программ- 
ного обеспечения занимаются сотни или даже тысячи программистов, находя- 
щихся в разных уголках земного шара, а совокупный размер созданного ими 
программного кода превосходит возможности хранения, имеющиеся у персо- 
нальных компьютеров. Кроме того, этот код, являющийся интеллектуальной 
собственностью компаний, имеет значительную стоимость в денежном выра- 
жении. Не удивительно, что в целях предотвращения промышленного шпиона- 
жа у них возникает желание ограничить доступ сотрудников только теми участ- 
ками кода, над которыми они непосредственно работают. 

Для удовлетворения противоречивых требований приходится использо- 
вать вспомогательные модули для систем контроля версий, которые были рас- 
смотрены выше, или искать альтернативные продукты, коих на сегодняшний 
день имеется немало — как коммерческих, так и бесплатных. 


1.7. Интегрированная система РГо$$йЙ 


Эта книга посвящена бесплатной современной системе управления верси- 
ями Е055П, которая была разработана специально для поддержки проекта 
5ОГе, уникального в своём роде и заслуживающего отдельного освещения. 


ГИ 


В стандартной классификации Р0$$] — это распределённая система контроля 
версий, т. е. относится к тому же классу, что и ОИ. 

Каждый участник проекта, поддерживаемого Е0$51, обладает полной ко- 
пией всей истории изменений файлов проекта. Но модель разработки напоми- 
нает централизованную схему, потому что обмен результатами работы между 
участниками происходит через сетевой репозиторий, размещённый на сервере. 
В целом рабочий процесс с использованием Ео$$Й выглядит так (рис. 1.6). 


Сетевой 
репозиторий 


ее ееееееннннн-----я 


0 
00 
0 


Локальный 
репозиторий 


ирдае 


ореп 


о00 | 


Рис. 1.6 
Рабочий процесс с использованием Ео55И: 


пунктирной линией показаны первоначальные действия, выполняемые однократно при раз- 
вёртывании системы, сплошной — регулярно выполняемые действия в ходе работы над про- 
ектом. Подписи линий отражают действия, ими обозначаемые, и соответствуют командам 
системы управления версий Е0$$1. 


Развёртывание системы начинается с создания сетевого репозитория 
(1110), который затем копируется участниками проекта на их персональные ком- 
пьютеры (с1опе). После этого у них появляется возможность создать рабочие 
каталоги (ореп). 

Файлы из рабочего каталога могут добавляться в список контролируемых 
системой Е0о5$1 (а), и тогда производимые в них изменения будут отслежи- 
ваться, а сами они будут включаться в моментальные снимки рабочего каталога, 
записываемые в точки сохранения репозитория (соттй). При необходимости 
можно снять контроль с файлов (гп), в результате чего они не будут присут- 
ствовать в последующих моментальных снимках, но навсегда останутся в тех, 
которые были сделаны ранее. 
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Чтобы результат операций, выполненных над рабочим каталогом и ло- 
кальным репозиторием одного участника проекта, стал доступен остальным 
участникам, каждый должен синхронизировать (зупс) свой локальный репози- 
торий с сетевым репозиторием. Процесс синхронизации заключается в получе- 
нии в локальный репозиторий отсутствующих в нём изменений из сетевого ре- 
позитория (ри!) и отправке изменений, выполненных участником после преды- 
дущей синхронизации, в сетевой репозиторий (риз|). 

Может оказаться, что пока разработчик модифицировал имевшийся у него 
на компьютере вариант файла, внесённые им изменения вошли в противоречие 
с версией, появившейся к этому времени в сетевом репозитории. Тогда при син- 
хронизации репозиториев системой контроля версий это противоречие будет 
обнаружено, разработчик получит сообщение о конфликте, и синхронизация бу- 
дет отложена до устранения конфликта. 

Лучший вариант решения конфликта — ознакомиться с наложившимися 
исправлениями и сформировать из них правильную комбинацию, после чего за- 
вершить синхронизацию репозиториев. Если оперативное решение конфликта 
по каким-то причинам невозможно, то существует вариант его эскалации — ос- 
новная линия разработки проекта разветвляется (ЮтК), в результате чего возни- 
кает ответвление (БтапсВ), в котором файл, явившийся причиной конфликта, по- 
лучит только те изменения, которые произвёл разработчик. А вариант файла с 
конфликтующими изменениями, имеющийся в сетевом репозитории, останется 
в основной ветке проекта. 

С точки зрения развития проекта его ветви, появившиеся в результате не- 
разрешённых конфликтов, надо как можно скорее приводить к общему знамена- 
телю и объединять (тегое) с основной ветвью. В то же время наличие парал- 
лельных ветвей разработки для тестирования новых функций, исправления 
ошибок или сопровождения конкретных выпусков продукта проблемой не явля- 
ется. Возможность в произвольный момент переключиться на любой из ранее 
созданных моментальных снимков рабочего каталога (сНесКои®) и внести в него 
необходимые изменения является одной из основных причин использования си- 
стем контроля версий. 

В целом описанная выше методика характерна для многих современных 
систем контроля версий. Ноу Ео$$1 есть несколько особенностей, которые вы- 
деляют её на фоне конкурентов. 

Во-первых, в качестве хранилища своих данных Е05$51 использует локаль- 
ную СУБД ЗОГе — очень надёжное, совместимое и легко переносимое на 
различные платформы решение. Это упрощает администрирование системы: 
все данные репозитория сосредоточены в одном файле, а сведения о состоянии 
рабочего каталога — в другом. Файлы формата ЗОГие без изменений могут 
быть перенесены на другую платформу и продолжат работать там без каких бы 
то ни было проблем. 

Во-вторых, в Еоз$Й помимо собственно системы контроля версий входит 
набор подсистем, реализующих полезные в работе над проектом функции: 

® управление заявками на доработку (Виз Тгаск1тз); 

® документирование (У К1); 
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® обсуждение (Еогитп); 

® веб-сервер. 

Для использования перечисленных инструментов с другими системами 
контроля версий требуются подключение и настройка дополнительных модулей 
или сторонних программных продуктов. В Ео$5И они реализованы с помощью 
того же механизма, на котором работает версионированное хранение файлов 
проекта. Такое решение экономично как с точки зрения повторного использова- 
ния программного кода, так и с точки зрения эффективного хранения данных 
этих подсистем. Вся информация находится в одном файле базы данных ЗОГЁе, 
что исключает утрату истории доработок, обсуждения или сопроводительной 
документации проекта. 

Встроенный в Ео3$1 веб-сервер служит как для предоставления доступа к 
наглядному и функциональному веб-интерфейсу, так и может быть использован 
для быстрого развёртывания и дальнейшего функционирования статического 
веб-сайта. 

В-третьих, все функции Е0551 реализуется одним-единственным исполня- 
емым файлом, который не имеет зависимостей от сторонних библиотек. Это 
упрощает до минимума как установку системы, так и её сопровождение. 

Благодаря перечисленным особенностям система Ео$3 становится при- 
влекательной для индивидуальных разработчиков, которых в иной ситуации 
могла бы отпугнуть сложность нового, пусть и полезного, инструмента. 

Систему Роз; можно использовать в образовании. На еб основе легко со- 
здать учебный стенд для демонстрации не только основных положений систем 
контроля версий, но и смежных инструментов, активно используемых в реаль- 
ных проектах. 

На эту систему стоит обратить внимание и организациям, в коллективах 
которых по каким-то причинам система контроля версий ещё не применяется. 
По сравнению с современными альтернативами у неё может и не быть явных 
преимуществ, но какая-нибудь из перечисленных особенностей может оказаться 
полезной. 

Взаимодействие пользователя с системой Е0о5$Й осуществляется двумя 
способами: посредством командной строки и через веб-интерфейс. Из команд- 
ной строки, открытой на рабочем каталоге проекта, можно быстро записать со- 
стояние рабочего каталога в репозиторий и запросить обновления. Через веб- 
интерфейс удобно производить настройку системы, просматривать шкалу вре- 
мени проекта и статистику, участвовать в обсуждениях на встроенном форуме 
(рис. 1.7). 

Основные элементы веб-интерфейса системы Е05$ показаны на рисун- 
ке 1.8. В самом верху клиентской области окна веб-браузера отображается стро- 
ка заголовка (1). Она содержит название открытого репозитория и обозначение 
текущего режима работы, которые разделены наклонной чертой. В правом 
верхнем углу находится гиперссылка Гозт (2), с помощью которой пользова- 
тель может авторизоваться в системе и получить доступ к выполнению разре- 
шённых ему операций. После авторизации там будут отображаться имя учётной 
записи активного пользователя и гиперссылка для выхода из системы [.02004. 
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Рис. 1.7 
Веб-интерфейс системы Ео55Й в режиме отображения статистики работы над проектом 
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Рис. 1.8 
Основные элементы веб-интерфейса системы Ео55И: 


1— заголовок; 2— гиперссылка для авторизации в системе; 3— строка главного горизон- 


тального меню; 4— строка дополнительного горизонтального меню. Стрелкой обозначен 
пункт вызова раскрывающегося меню. 
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Под строкой заголовка находится главное горизонтальное меню (3) си- 
стемы Еоз$$1, в котором можно выбрать желаемый режим работы. В этом меню 
представлены только основные возможности, кроме того, состав пунктов меню 
может сокращаться при уменьшении ширины окна веб-браузера. Первым в 
главном меню идёт пункт вызова раскрывающегося меню (на рисунке обозна- 
чен жирной стрелкой), в котором представлен исчерпывающий список режимов 
работы, разрешённых текущему пользователю. Некоторые режимы работы 
Ео5$П предоставляют пользователю дополнительные возможности, выбор кото- 
рых осуществляется в дополнительном горизонтальном меню (4). 

При использовании командной строки в окне терминала операционной 
системы вводятся с клавиатуры команды в формате: 


Ео$$511 команда параметры 


Например, наиболее часто используемая в ходе работы над проектом ко- 
манда загрузки в репозиторий состояния рабочего каталога выглядит следую- 
щим образом: 


05511 сопи16 -м "Описание выполненной работы" 


Несмотря на то, что некоторые операции можно выполнить как через веб- 
интерфейс, так и из командной строки, перечисленные способы работы с Ро5$ 
являются взаимодополняющими. При отсутствии практики работы в режиме 
командной строки первоначально может ощущаться дискомфорт, но ввод ко- 
манд с клавиатуры быстро входит в привычку. 
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Глава 2 
УСТАНОВКА ЕО$ЗЗ- 


2.1. Получение исполняемого файла 


Исчерпывающее описание установки Е05$1 можно уместить в один абзац. 
Вся функциональность этой системы заключена в единственном исполняемом 
файле. Поэтому для её установки надо загрузить с официального сайта 
9 рз://о$$1-зст.ого/ (рис. 2.1) архив с исполняемым файлом, извлечь этот файл и 
разместить в каталоге, который включён в список путей поиска программ по 
умолчанию. 


= х 
{ Гоз5Й: омюад Раде х + — 
— с @ 1055-сст.огд/поте/им/домитюаа. Вт * © 
Го$$ В р / Оомитюад Раде Годт 
= Ноте Титейте Оос$ Соде Зиррой Бом/ипюаа 


То шз{а| Ро$$И —+ до\м/поад {Пе $апд-аопе ехесщаЫе апд ри # оп уосчг $РАТН. 


\Мегзюп 2.10 (2019-10-04) 


дед 


Ипих хб4 Масо$ 10х  КВазрБепуР! \МАпдо\/ 532 \М/пдом/ 564 Зоугсе Тара! 
2.99 МВ 2.36 МВ 1.23 МВ 2.26 МВ 2.67 МВ 5.63 МВ 
Ном 115 домпюад раде 15 третешед 
Но\м/ Ме гееазе 15 Би 
Рис. 2.1 


Страница загрузки исполняемых файлов и исходных текстов системы Ео55Й 


Вероятно, многие читатели этой книги в дополнительных инструкциях не 
нуждаются. Тем не менее давайте вспомним команды, которые требуется вы- 
полнить для установки Ео$$Й в разных операционных системах, рассмотрим 
пример сборки Еоз$1 из исходных текстов и обсудим вопросы, касающиеся по- 
вышения удобства использования Е0$551 в повседневной работе. 

Помимо загрузки исполняемого файла с официального сайта, в популяр- 
ных дистрибутивах операционной системы ОМОЛАпих имеется возможность 
получения его штатными средствами операционной системы из официального 
репозитория программного обеспечения. Например, чтобы установить Е0$$1 в 
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операционной системе, основанной на дистрибутиве Убит или Ое5ап, надо в 
терминале от имени суперпользователя гоо{ выполнить команду: 


арЕ-чеЕ 1п$6а11 Ео$$11 


В дистрибутиве Мазаа, который использует пакеты ВРМ, того же резуль- 
тата можно достичь с помощью команды: 


итрт1 Е0$$11 


Даже в репозитории операционной системы МП\Х 3 имеется двоичный 
пакет системы Ро$$, правда, устаревшей на сегодняшний день версии 1.28. 
Установить его можно с помощью команды: 


рРКа1п 1п56а11 05511 


Установка Еозз из репозитория во многих случаях является наиболее 
предпочтительным вариантом, потому что избавляет от необходимости зани- 
маться вопросом размещения загруженного исполняемого файла в правильный 
системный каталог. После такой установки программа сразу готова к использо- 
ванию. 

Однако в некоторых ситуациях может потребоваться сборка исполняемого 
файла из исходных текстов. Пользуясь случаем, рассмотрим выполнение этой 
процедуры в операционной системе МПИХ 3, чтобы получить и для неё самую 
актуальную на момент написания книги стабильную версию Ео$$1 2.10. 


2.2. Сборка из исходных текстов 


Для сборки исполняемого файла Ео$5И из исходных текстов в среде опе- 
рационной системы МПМХ 3 потребуются инструменты, представленные паке- 
тами пи и с!апе. Если они ещё не были установлены, то от имени супер- 
пользователя гоо{ надо выполнить команды: 
рКа1п прааее 
рРКа1п 1п56а11 11115 
рКа1п 1п56а11 с1апач 

Чтобы конфигуратор Ео$5И обнаружил установленный компилятор с1апз, 
надо создать символическую ссылку: 

10 -з /азк/рка/61п/с1апа /изк/рка/Б1т/сс 

Дальнейшие действия можно выполнять от имени рядового пользователя 
операционной системы. Прежде всего, потребуется загрузить с официального 
сайта проекта Ео$$1 исходные тексты устанавливаемой программы с помощью 
команды: 


Еер БЕЕр://Еоз$11-зсм.ога/поме/чу/Ео$$11-з:с-2.10.5аг.92 
Здесь нет ошибки, в операционной системе МПШХ 3 программа Ёр умеет 
загружать файлы из сети по протоколу НТТР. В результате в текущем каталоге 


должен появиться файл Ю$$1-$гс-2.104аг.07. Для его распаковки надо ввести ко- 
манду: 


Таг 2хЕ Е05511-5:с-2.10.5аг.927 
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В текущем каталоге появится подкаталог ю5$31-2.10. Теперь надо сделать 
каталог с исходными текстами текущим, выполнить конфигурирование исход- 
ных текстов и запустить процесс сборки исполняемого файла: 
са Еоз$11-2.10 
./сопЕ1айаке 
паке 


Вероятнее всего, через несколько минут на экране появится сообщение об 
ошибке: 


с1апа: магп1па: агкаимепЕ ипазеая аик1пч сопр11а®1оп: '-9' 
Ь1а/р1есваг®.о: Ти ЕапсЕфоп 'рфесрагЕ_кепаег': 
/роме/из5х/Ео$$11-2.10/./зкс/р1еспаке.с:177: ипаеЕ1пеая кеЕегкепс 
Бо '51п' 

/роме/из5х/Ео$$11-2.10/./зкс/р1есваге.с:178: ипаеЕ1пеая кеЕегепс 
Бо 'со$' 

/роме/из5х/Ео0$$11-2.10/./зкс/р1есвак®е.с:180: ипаеЕ1пеая геЕегепс 
Бо '51п' 

/роме/из5х/Ео$$11-2.10/./зкс/р1есваке.с:181: ипаеЕ1пеая кеЕегкепс 
ЕО.. 'с05" 

/роме/из5х/Ео$$11-2.10/./зкс/р1еспаке.с:193: ипаеЕ1пеа кеЕегкепс 
Бо '51п' 

/роме/из5х/Ео0$$11-2.10/./зкс/р1еспаге.с:194: ипаеЕ1пеая кеЕегепс 
Бо 'со$' 

Ь1а/за11Ее3.о: Ти ЕРапсЕ1оп 'ЕЕз5Вщ25СеЕрафа' : 
/роме/из5х/Ео$$11-2.10/./зхс/за11е3.с:206042: ипаеЕлреая геЕегепс 
Со '1од' 

с1апа: екгог: 11пКег соштапа Еа11еа м1ЕП ех1Е соае 1 (изе -у во 


зее 1пуоса®е1оп) 


В нём сообщается о том, что компоновщик не нашёл библиотеку с реали- 
зациями функций $ и со$. Для устранения этой ошибки надо открыть в тексто- 
вом редакторе файл Маке#е, найти строку, в которой устанавливается значение 
переменной [/В, и дописать в ней опцию -ри. Строка должна приобрести вид: 


ТВ = -Г/чзк/рка/11Ъ -15$1 -1скурво -12 -1м 
После этого надо сохранить файл, выйти из редактора и повторно ввести 
команду таке. В текущем каталоге появится исполняемый файл 103$. Чтобы 


установить его в операционную систему, надо от имени привилегированного 
пользователя выполнить команду: 


паке 1п$56а11 


Она запишет собранный из исходных текстов исполняемый файл в ката- 
лог /изЛосаМот, после чего он станет доступен для использования. Проверить 
результат установки можно с помощью команды: 


Ео$$11 уег$з1оп 
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Она выведет на экран сообщение о версии Е0о$$1: 
ТЬ1$ 15$ Е0$5$11 \уегз1оп 2.10 [9а9еЕ82234] 2019-10-04 21:41:13 ОТС 


Таким образом, самая актуальная стабильная версия Еозз была собрана 
из исходных текстов и установлена в операционную систему. 


2.3. Подготовка к использованию в \М\/Мтадо\м$ 


Казалось бы, установка Ео$51 в операционной системе \/т4до\$ не долж- 
на вызывать никаких проблем. Что может быть проще, чем записать один- 
единственный ЕХЕ-файл в каталог, прописанный в переменной окружения 
РАТН? И правда, в прошлых версиях операционной системы это смог бы про- 
делать любой подготовленный пользователь. 

В современных версиях \т4о\з всё может оказаться не так просто, как 
ожидалось. С одной стороны, в каталоги, которые уже прописаны в переменной 
окружения РАТН, запись разрешена только пользователям с правами админи- 
стратора системы. И это разумно, потому что удерживает от простого, но не- 
правильного решения поместить программу Ю$3Й.ехе в какой-нибудь из систем- 
ных каталогов. Это — опрометчивый шаг как с точки зрения безопасности си- 
стемы, так и с точки зрения поддержания её чистоты. С другой стороны, не так- 
то просто добраться до окна интерфейса, посредством которого можно изме- 
нить перечень каталогов, в которых осуществляется поиск программ по умол- 
чанию. 

Ниже описан наиболее рациональный с точки зрения автора способ уста- 
новки программы Ю35й.ехе, пригодный для использования в любой версии опе- 
рационной системы \\!1т490о\5. 

Во-первых, надо создать отдельный каталог для однофайловых программ. 
Сейчас туда будет помещён файл 10$$1.ехе, но в дальнейшем в него же можно 
записывать другие полезные утилиты. Имя каталога должно быть максимально 
простым (содержать только латинские буквы) и коротким, а также находиться 
максимально близко к корню файловой системы, чтобы исключить как трудно- 
сти его включения в переменную РАТН, так и проблемы работы запущенных из 
него программ. Хороший вариант имени — ЕХЕ, а местоположения — корень 
системного диска. Итак, создаём каталог СЛЕХЕ и записываем в него программу 
055$1.ехе. 

Теперь путь СЛЕХЕ надо добавить в переменную окружения РАТН. От- 
кроем окно командной строки \19о\з (для этого надо нажать комбинацию 
клавиш \!шКеу + К, набрать ста.ехе в открывшемся окне, после чего нажать 
кнопку Ок (рис. 2.2). 

Затем в окне командной строки надо ввести команду зузат.ср!, после чего 
система выведет окно системы контроля учётных записей, в котором надо раз- 
решить работу оснастки нажатием кнопки Да. В окне оснастки Свойства си- 
стемы (рис. 2.3), которое откроется после этого, надо выбрать вкладку Допол- 
нительно и нажать кнопку Переменные среды... 
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22 Выполнить 


Введите имя программы, папки, документа или ресурса 


Интернета, которые требуется открыть. 


Открыть: стд.ехе 


Рис. 2.2 
Вызов окна командной строки Ийи4ому 


Свойства системы 


$ Имя компьютера Оборудование 
Дополнительно Защита системы Удаленный доступ 


Необходимо иметь права администратора для изменения большинства 
перечисленных параметров. 


Быстродействие 


Визуальные эффекты, использование процессора, оперативной и 
виртуальной памяти 


` Параметры... 


Профили пользователей 


Параметры рабочего стола, относящиеся ко входу в систему 


Загрузка и восстановление 


Загрузка и восстановление системы, отладочная информация 


Рис. 2.3 
Окно оснастки Свойства системы 
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Откроется окно редактирования переменных среды, состоящее из двух 
частей (рис. 2.4). В верхней части находятся переменные, действующие только 
для текущего пользователя операционной системы, в приведенном примере это 
РСУзег. В нижней части находятся переменные, которые действуют для всех 
пользователей операционной системы. 


Переменные среды х 


Переменные среды пользователя для РСИзег 


Переменная Значение 

ОпеОпме % САУзегя\РСУзег\ОпеОпуе 

Ра САОзегя\РСУзепАррОа*а\Госа\МисгозоН\\Мптдом5Арр5;САРгодгат ... 
ТЕМР САУзег\РСУзе\Аррбаа\Госа\Тетр 

ТМР САУзег\РСУзе\Аррба!а\оса\Тетр 


‘Создать... Изменить... Удалить 
Системные переменные 
Переменная Значение и 
Сотбрес САМИМООМ/\у$ет32\ст@.ехе 
ОпуегОаа СА\МИпдоми\5у$ет32\Опуег<\ОпмегОайа 
МУМВЕВ_ОЕ_РКОСЕ$$О0В$ 4 
05 МИпдоми;_МТ 
Ра САРгодгатВаа\Огасе\)ауа\амараН;САМИМОО\М/$\у$ет32;СА... 
РАТНЕХТ „СОМ;.ЕХЕ;.ВАТ;.СМО; МВ$; МВЕ;.5;.25Е; МИЗЕ, МИ$Н;.М$С 
РКОСЕ$$ОВ_АКСНПЕСТИВЕ х86 у 
Создать... Изменить... Удалить 


он 


Рис. 2.4 
Окно редактирования переменных среды 

Исправим значение переменной среды окружения РАТН для текущего 
пользователя. Для этого надо в списке переменных выбрать строку, начинаю- 
щуюся с Рай, после чего нажать кнопку Изменить... Откроется окно Изменить 
переменную среды (рис. 2.5). 

В открывшемся окне надо нажать кнопку Создать. Это активирует строку 
редактирования, позволяющую добавить новый путь к списку существующих пу- 
тей переменной среды окружения РАТН. В строке редактирования надо набрать 
СЛЕХЕ, после чего нажать кнопку ОК в окне изменения переменных среды. 
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Изменить переменную среды х 


3% И5ЕВРКОРТЕ%\АррОа!а\Госа\Мисгозо \\Ипдоми5Аррз Создать 
С;А\Ргодгат Е|ез\Вимее 55Н СйЙегп{ 
СЛЕХЕ Изменить 
Обзор... 
| Удалить 
Вверх 
Вниз 
Изменить Текст... 


о 


Рис. 2.5 
Окно внесения изменений в переменные среды 


Задача выполнена — путь к новому каталогу для исполняемых файлов 
добавлен. Оставшиеся на экране диалоговые окна можно закрыть нажатиями на 
кнопку ОК. Осталось записать в каталог С\ЕХЕ программу ю$$1.ехе, если это 
ещё не было сделано. Теперь операционная система будет находить программу 
при указании только её имени, без необходимости задания полного пути к её 
местонахождению. 


2.4. Альтернативный способ для \\т4ом$ 


Если изменять значения переменных окружения для всего сеанса работы 
операционной системы нежелательно или такая возможность отсутствует в си- 
лу установленных администратором политик, можно организовать работу с си- 
стемой контроля версий иначе. Возможно, кто-то даже увидит в предлагаемом 
варианте преимущества по сравнению с тем, который был рассмотрен ранее. 

Система контроля версий управляется из командной строки, в которой те- 
кущим должен быть рабочий каталог проекта, над которым ведётся работа. 
Можно совместить действия по запуску сеанса командной строки, установке 
текущего рабочего каталога и указанию пути к программе Тю$$й.ехе. Далее пред- 
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полагается, что программа !ю$$1.ехе размещена в каталоге СЛЕХЕ, но настройка 
переменной окружения РАТН не производилась. 

Для изменения значения переменной среды окружения РАТН в каталоге 
СЛЕХЕ надо создать командный файл 10$$-епу.ба! со следующим содержимым: 


Листинг командного файла СЛЕХЕ\Ю5$й-епу.ба! 


@ЕСНО ОЕЕ 
СНСР 65001 
РАТН %РАТН%;С: \ЕХЕ 
ЕСНО Система контроля версий готова к работе. 


В первой строке командного файла отключается вывод на экран самих 
выполняемых команд. Вторая строка устанавливает кодовую страницу номер 
65001, что соответствует кодировке ОМСОПЕ (по умолчанию командная стро- 
ка \!т4о\$ использует кодировку СР-866). Это обеспечит нормальную переда- 
чу в систему контроля версий описаний изменений на русском языке, в против- 
ном случае при просмотре информации через веб-интерфейс вместо них будут 
отображаться спецсимволы. В третьей строке к содержимому переменной 
окружения РАТН добавляется путь СЛЕХЕ. И, наконец, последняя строка просто 
выводит на экран информационное сообщение. 

Использовать командный файл 10$5й-епу.Ба{ надо с помощью ярлыка, кото- 
рый создаётся следующим образом. Щелчком правой кнопкой мыши на свобод- 
ном пространстве рабочего стола вызывается контекстное меню, в котором вы- 
бирается пункт Создать — Ярлык (рис. 2.6). 


Вид > 
Сортировка р 
Обновить 


шеф» Создать У 


Г] Параметры экрана 


Папку 


Ярлык «= 


ЕЙ Персонализация Точечный рисунок 


| Орепбоситеп Огамипд 
ОрепВоситепЕ РгезегйаНоп 


ОрепВоситепЕ 5ргеад5 Нее! 


82 82 62 © 80| м Г 


Документ в формате ЕТЕ 


Текстовый документ 


| 


Сжатая !Р-папка 


Рис. 2.6 
Вызов диалогового окна для создания ярлыка 
В поле ввода Укажите расположение объекта появившегося диалогового 
окна Создать ярлык надо набрать текст команды (рис. 2.7): 


%СОМ$РЕСУ /К С: \ЕХЕ\Еоз$11-епу.рбае 
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я Создать ярлык 


Для какого элемента нужно создать ярлык? 


Этот мастер помогает создать ярлык, указывающий на локальные или сетевые программы, 
файлы, папки, компьютеры или адреса в Интернете. 


Укажите расположение объекта: 


%СОМ5РЕС% /К СЛЕХЕ\#055Й-епм.Ба Обзор... 


Для продолжения нажмите кнопку "Далее". 


о 


Рис. 2.7 
Командная строка создаваемого ярлыка 


При выполнении этой команды на место ®%СОМ5РЕСФХ будет подставлен 
полный путь к командному интерпретатору ст@.ехе, параметр /К означает, что 
командный интерпретатор не должен завершать свою работу после выполнения 
командного файла, полный путь к которому указан после этого параметра. 

После нажатия кнопки Далее будет предложено указать название ярлыка. 
Хорошее решение — вписать в это поле краткое название проекта, над которым 
будет вестись работа (рис. 2.8). 


< и Создать ярлык 


Как назвать ярлык? 


Введите имя ярлыка: 


Проект Вебсайт 


Чтобы создать ярлык, нажмите кнопку "Готово". 


Отмена 


Рис. 2.8 
Ввод названия ярлыка 
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После нажатия кнопки Готово на рабочем столе появится созданный яр- 
лык. Осталось лишь немного его подкорректировать. Надо с помощью правой 
кнопки мыши вызвать на этом ярлыке контекстное меню, выбрать в нём пункт 
Свойства. На вкладке Ярлык в поле Рабочая папка: следует указать путь к рабо- 
чему каталогу проекта (он должен существовать к этому моменту) и нажать 
кнопку ОК (рис. 2.9). 


ЗЫ Свойства: Проект Вебсайт х 


Термины Безопасность Подробно Предыдущие версии 
Общие Ярлык Настройки Шрифт Расположение Цвета 


в Проект Вебсайт 


Тип объекта: Файл 


Расположение: 


Объект: %СОМ$РЕСУ, /К СЛЕХЕ\оз3й-епу Ба! 


Рабочая папка: \О\\//ОНК\мебэйе 


Быстрый вызов: |Нет 


Окно: Обычный размер окна ве 


Комментарий: 


Расположение файла ’'Сменить значок... | Дополнительно... 


Рис. 2.9 
Ввод пути к рабочему каталогу 
С помощью созданного ярлыка будет запускаться окно командной строки 
с кодировкой ОМГСОПЕ, в котором текущим сразу станет рабочий каталог про- 
екта, и путь к программе 1ю$$1.ехе будет добавлен в переменную окружения 
РАТН. Такие ярлыки можно создать для всех текущих проектов и поместить их 
в отдельную папку на рабочем столе. 
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Глава 3 
ПОДГОТОВКА К РАБОТЕ НАД ПРОЕКТОМ 


3.1. Описание проекта 


После того, как система Ео$5И установлена на компьютере и готова к ис- 
пользованию, можно приступать к работе над проектом. Ранее уже было сказа- 
но, что систему Ео$5 может эксплуатировать как индивидуальный разработчик, 
так и команда из нескольких человек. Первый вариант проще, и рабочий про- 
цесс можно описать линейно, в форме рассказа. Второй вариант может предо- 
ставить большее разнообразие ситуаций, и описание процесса разработки будет 
напоминать роман, в котором взаимодействуют несколько персонажей. 

Для более полного раскрытия возможностей системы Ео$$Й дальнейшее 
повествование будет ориентировано на её коллективное использование. Инди- 
видуальные разработчики при чтении могут пропустить эпизоды, в которых 
описывается настройка сервера и учётных записей пользователей. Но для полу- 
чения всестороннего представления о системе будет не лишним ознакомиться 
со всеми рассмотренными аспектами. 

Чтобы изложение не превратилось в сухой перевод на русский язык стан- 
дартной документации, будем рассматривать пусть и вымышленный, но кон- 
кретный пример. Это позволит наглядно обыграть несколько возможных ситуа- 
ций и упростит восприятие материала. 

Предположим, что перед небольшой командой специалистов, состоящей 
из менеджера, верстальщиков и дизайнеров, поставлена задача разработки шаб- 
лона простого одностраничного веб-сайта в соответствии с представленным на 
рисунке 3.1 образцом. Исходя из основных требований к продукту: простота, 
компактность, адаптивность к устройствам просмотра, независимость от сто- 
ронних библиотек и лицензионная чистота — выбрана стратегия разработки с 
ориентацией на веб-стандарты. Решено использовать чистые НТМГ, С55 и 
Тауа$спре. 

Поскольку эта книга не является учебником по языкам веб-разработки, 
основное внимание в ней сосредоточено не на раскрытии секретов вёрстки или 
дизайнерских находок, а на организации рабочего процесса, прежде всего — 
совместного использования исходных текстов проекта. 

Подготовка к работе над проектом с использованием системы Ео35П 
включает следующие шаги: 

® создание файла репозитория; 

® выполнение первичной настройки репозитория; 

® размещение репозитория на сервере и предоставление к нему сетевого 
доступа; 

® настройка учётных записей пользователей репозитория. 

Рассмотрим их подробно. 
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О компании 


Рога и копыта 
натуральный продукт 
от первого поставщика 


О компании 


Общество с ограниченной ответственностью 
«Рога и копыта» основано в 1927 году в 
городе Черноморске, 
экологически чистой окружающей средой. 


Состав Правления: 


Основатель компании 
Ибрагимович Бендер, 
профессиональных кругах предприниматель, 


бизнесмен, инноватор. 


который 


Продукция 


славится 


Остап 
известный в 


Партнёры Вакансии Приёмные пункты 


Александр Петрович Балаганов — уполномоченный по копытам. 
Паниковский Михаил Самуэлевич — директор департамента транспорта и логистики. 


Продукция 


Предлагаем заботливо собранные и 
тщательно обработанные рога и копыта 
самого высокого качества для нужд 
гребёночной и мундштучной 
промышленности. С нашими рогами и 
копытами ваш бизнес достигнет вершин 
успеха и процветания! 


Мы представлены в сети Интернет: 


м + 


Будем рады сотрудничеству! 


Рис. 3.1 


Образец простого одностраничного веб-сайта 
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3.2. Создание репозитория 


Каждый Еоз$-репозиторий представляет собой отдельный файл базы 
данных ЗОГ Ще, в котором хранятся все элементы проекта и вся история его из- 
менений, вплоть до текущего состояния. Внутренняя структура файла Еоз$51- 
репозитория одинакова во всех операционных системах и не зависит от архи- 
тектуры компьютера. 

Файлы Ео$5П-репозиториев можно копировать с одного компьютера на 
другой без риска потери их работоспособности. С одной стороны, это открыва- 
ет простой путь к резервному копированию репозиториев. С другой, нельзя за- 
бывать, что в файле копии Е0$$-репозитория находится вся имеющаяся в ори- 
гинальном репозитории информация, и обладатель такого файла может беспре- 
пятственно получить к ней доступ. Поэтому с точки зрения информационной 
безопасности доступ к файлам Еоз$-репозиториев следует ограничивать. 

Рассматриваемый в этой книге проект называется «Простой одностра- 
ничный веб-сайт», что может быть переведено на английский язык как «Зпире 
зше]е-разе \ебзце». Поэтому назовём файл репозитория ззрмебзНе.ю$$1. Рас- 
ширение $$ говорит о том, что содержимое файла является Еоз$П-репо- 
зиторием, причём не только пользователю, но и веб-серверу Ео$$1, о чём будет 
подробнее рассказано в соответствующей главе. 

Для создания файла репозитория с именем ззрмебзНе.Ю$$Й надо выпол- 
нить команду: 


Ео$$11 1016 --аап1п-изек бебарОзег ззрмебз1Ее.Ео$$11 


Параметр --адтт-изег позволяет указать имя пользователя — создателя и 
единоличного владельца репозитория, который будет обладать неограниченны- 
ми правами в отношении созданного репозитория. В приведенном примере это 
пользователь с именем ЗаирИзег. Если же этот параметр опустить, то по умол- 
чанию владельцу репозитория будет дано имя текущего пользователя операци- 
онной системы. 

В случае успеха на экран будет выведена информация о созданном репо- 
зитории примерно такого вида: 


рго]есЕ-14: а9ас10379940е886735а86с2а7694947аЪ3а49е?7 
зегуег-1А: 7е6Ъ7867е097327027697е0сбс1ЕЕссае8с13с3За 
а9т1п-изег: бебирОзег (1п161а1 раззмога 1$ "6787еа") 


В этих сведениях особый интерес представляет последняя строка, в кото- 
рой указан начальный пароль пользователя — создателя репозитория, в данном 
случае 6787еа. Этот пароль требуется для управления репозиторием с другого 
компьютера по сети, о чём будет сказано позже. А сейчас приступим к первич- 
ной настройке созданного репозитория. 
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3.3. Первичная настройка репозитория 


Настройка репозитория выполняется через веб-интерфейс. Доступ к нему 
проще всего получить, если на том же компьютере, где находится файл репози- 
тория, выполнить команду: 


Ео$5$11 1 ззрмерз16е.Ео$$11 


В приведённой команде ззрмебзКею$$1 — это имя файла с репозиторием. 
Результатом её выполнения будет запуск веб-браузера и открытие в нём домаш- 
ней страницы проекта (рис. 3.2). 


Уппатед Роз$И Рго]есё Ноте 


с ® О осаво5Е8080дпае я [АВЕ © 


Уппатеа Го$$й Рго]ес{ / ноте — зашжьы пом 


Ноте Ттейпе Нез Вгапспез Адтт 


ТВ5 {5 а м6 поте-раде Гог {Пе ргоес+. То Я! т {115 раде, #гз{ до {о апа ез{а В а 
"Ргоес{ Мате". ТВеп сгеае а млК! раде м И {Па{ пате. Тпе сощепЕ о! {Паё млК! раде мм! Бе 
зр!ауед т расе о! {715 теззаде. 


Рис. 3.2 
Домашняя страница проекта, открытая в веб-браузере. 
Для выполнения настроек надо перейти по гиперссылке зеир/сопйя 

По факту при выполнении этой команды запускается веб-сервер на ТСР- 
порту 8080 локального сетевого интерфейса, и веб-браузеру предписывается от- 
крыть страницу с адресом НЯр:/Лосао${:8080/паех. При этом автоматически, без 
запроса пароля, происходит вход в систему управления репозиторием под име- 
нем пользователя-владельца, в данном случае — ЗерОзег. Это означает, что 
любой пользователь, получивший непосредственный доступ к компьютеру с 
файлом репозитория, может выполнить с ним любые действия. 

Может оказаться, что порт 8080 на компьютере уже занят каким-нибудь 
другим сетевым приложением. В этом случае веб-сервер попытается использо- 
вать следующий по порядку ТСР-порт с номером 8081. 

Поскольку веб-сервер, запускаемый для настройки репозитория, привязы- 
вается к локальному сетевому интерфейсу юосаНоз получить к нему доступ с 
другого компьютера через сеть нельзя. Процедура предоставления сетевого до- 
ступа к репозиторию будет описана ниже. 

Для первичной настройки репозитория надо перейти по гиперссылке 
зеир/сопйа, в результате чего откроется форма, изображённая на рисунке 3.3. 
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Достаточно заполнить три верхних поля: Рго]ес{ Мате — название проекта, 
Ргодес! ВезсирНоп — описание проекта, и Тата! апа 71Р-агсй№е Ргейх — префикс 
(аг- и 71р-архива. 


Иппатед Роззй Ргодесё МАМАМ Со Х Мам 


< с ® О юсаво$:8080/5ейир_сопйд Е -- ож ю® = 


^ 


ЧУппатед Ро$$И Рго]есе / илл соппоигавоп 


ЗешрУзег — 1090 


Ноте Титетпе [йе Вгапспез Ади 


Арр! Свапдез аи 


Зитре зэтае-раде меьзНе Рго]ес* Мате 


А Бе! ргоес{ пате 50 м 5йог Кпо\и ммпаЕ {5 йе 15 абош. ТПе ргоес{ пате ми! або Бе изед аз 
{пе К$$ {еед Ше. (Ргорепу: "ргоес{-пате") 


Простой одностраничный веб-сайт, построенный на основе веб-стандартов. 


Рго]ес! Оезсир#оп 


Оезспбе уочцг ргоес{. ТР!$ миЙ Бе изед т раде Пеадегз Тог зеагсп епдтез аз ме! аз а пой К$$ 
дезспрноп. (Ргорепу: "ргоес!-дезспр#оп") 


[ззр-меБзИе | ТагБай апа 2!Р-агсН ме Ргейх 


ТЬ5 15 и5е4 аз а ргейх оп {Пе патез о! депегаед {афа!5 апа ИР агспме. Рог Бе5{ гезий5, Кеер 
{715 ргейх БпеГапд амо зреса! свагац{егз зисп аз "/" апд "\". Е по {афай ргейх 15 зресйед, еп 
{пе ви! Ргоес{ Мате абоуе 15 изед. (Ргорепу: "5Пой-ргоес!-пате") 


Рис. 3.3 
Форма настройки репозитория. После заполнения полей 
надо нажать кнопку Арр/ Свапдез для сохранения изменений 

В первое поле вводится название репозитория, которое идентифицирует 
проект и отображается в заголовке его веб-сайта. Во второе поле вводится опи- 
сание проекта, которое будет использовано поисковыми системами, если к ре- 
позиторию будет открыт интернет-доступ. А в третье поле вводится текст, с ко- 
торого будут начинаться имена файлов с архивами, содержащими рабочие фай- 
лы проекта, при их загрузке с веб-узла. 

После заполнения полей для сохранения введённой информации надо 
нажать кнопку Арру Спапдез (Применить изменения), которая дублируется 
вверху и внизу формы. Если в дальнейшем потребуется внести изменения в вы- 
полненные настройки, эту форму можно открыть через меню созданного проек- 
та Аатт | Сопйдиганоп (рис. 3.4). 
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эитре зтоде-раде уиебзИе: бегуе ЖХ 


<) > СФ О О ьсаюозвоводешр .. » 


тре зэтае-раде меьзКе / 


Зегуег Аатитетганоп 


= Ноте  Ттете | Адтют 


Озегз Сгап рим едез 40 памачца! изегз 


ЗешрИзег — 1одо\ 


Ассезз Сопго| ассез$ зеп9$ 
Сопйдигайоп] Сопйдиге пе \/МЛЛМ/ соппропепЁз ог {Пе герозйогу 
Зеситу-Ацай Апауге Пе ситег сопйдиганоп фог зеситу ргоМеп> 
Зе#паз \/\еБ ище[Гасе \ю {Пе 0551 зе пд5" согптапа 
Ттейпе Титетпе 4зр/!ау ргегепсез 


одт-Сгоур Мападе эпае эюп-оп Бебмееп {115 герозйогу апд о!Пегх 
оп {йе зате зегмег 


Рис. 3.4 
Вызов формы настроек репозитория через меню созданного проекта 


3.4. Настройка сетевого доступа 


Созданный файл репозитория ззрмебзНе.ю$$! можно разместить на серве- 
ре и предоставить к нему совместный доступ для коллективной работы над 
проектом. Для этого нужно на сервере установить программу ю$$1, переписать 
на серверный носитель информации файл репозитория (как уже было сказано, 
это можно сделать простым копированием) и выполнить команду: 


Ео$511 зекуег -Р 8081 ззрмерз1Ее.Ео$5$11 


С помощью параметра -Р указано значение ТСР-порта, на котором веб- 
сервер ЕоззЙ будет принимать запросы от клиентов. Его можно не указывать, 
тогда будет использован порт номер 8080. Об успешном запуске сервера гово- 
рит сообщение: 


Т1з6еп1па Еог НТТР геадаезЕ$ оп ТСР рогЕ 8081 
Туре СЕг1-С 6о 5збор (Пе НТТР зекуек 


Это же сообщение информирует о том, что для прекращения работы сер- 
вера Ео$51 в этом окне надо нажать комбинацию клавиш СИ + С. 

В отличие от запуска веб-интерфейса для настройки репозитория с помо- 
щью команды ю5$1 и, которая обсуждалась выше, теперь веб-сервер привязыва- 
ется не к виртуальному локальному сетевому интерфейсу осаНоз а к реальным 
сетевым интерфейсам компьютера и будет отвечать на любые поступающие из 
сети запросы. Для проверки его работы можно на другом компьютере запустить 
веб-браузер и набрать в адресной строке: Нйр:/Моз$1.зегуег:8081/, где 
05$1.зегуег — сетевое имя сервера. Вместо имени сервера допускается указы- 
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вать его 1Р-адрес, узнать который можно с помощью команды {рсопйд в опера- 
ционной системе \/т4до\$ или команды Нсопй#д в операционных системах Ух 
и Ипих. 

В случае успеха веб-браузер должен отобразить домашнюю страницу ре- 
позитория (рис. 3.5). Если страница не открывается, надо внимательно прове- 
рить набранный в адресной строке текст, убедиться в правильности указания 
номера порта (он должен соответствовать тому, который отображается в сооб- 
щении сервера). Причиной неработоспособности может быть брандмауэр сер- 
вера, блокирующий сетевые подключения. 


© тре этае-раде ммеБзйе: бит. Х + 


< с © Не защищено | |#ю0$$Й.5егуег:8081/пдех & х © 


эитр/[е зэтае-раде меь$Ке / зтре зпое-раде меьзйе 


[о ео 


— Ноте Тте!те Ре Вгапспез 


Нер 


Етру/ Раде 


Рис. 3.5 
Домашняя страница репозитория, вид из браузера на клиентском компьютере. 
Для авторизации надо перейти по гиперссылке ют 

В отличие от рассмотренного ранее случая локального доступа к Е0$$1|, 
при сетевом подключении не происходит автоматического входа в систему 
управления репозиторием. Пользователь должен авторизоваться в системе, вве- 
дя свои имя и пароль в форме, которая открывается при переходе по гиперссыл- 
ке Год (рис. 3.5). 

Для получения полного доступа к управлению репозиторием нужно ука- 
зать имя пользователя-владельца, использованное при создании файла репози- 
тория, его пароль, который был выдан в результате успешного создания файла, 
и нажать кнопку Ёодт (Войти). В рассматриваемом примере имя пользователя 
будет ЗеирИзег, а пароль — 6787еа4 (рис. 3.6). 

Необходимо отметить, что веб-сервер, интегрированный в Е0$51, работает 
по протоколу НТТР, в рамках которого осуществляется обмен сообщениями в 
открытом виде, без шифрования. Поэтому вся информация, которая передаётся 
между веб-браузером и сервером, включая регистрационные данные, может 
быть перехвачена третьей стороной. Это не всегда является проблемой при ра- 
боте во внутренней сети организации, однако неприемлемо при работе через 
Интернет. 
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Рис. 3.6 
Авторизация в системе управления репозиторием =: ввод имени пользователя и пароля 


В нижней части окна авторизации, показанного на рисунке 3.6, можно по- 
лучить сведения, достаточные для авторизации под именем пользователя 
апопуточ$. Пароль этого пользователя отображается средствами псевдографики 
и в рассматриваемом примере является строкой 59178 А1Б. 

Пришло время подробнее поговорить о пользователях Ро$31 и их правах. 


3.5. Совместная работа в информационных системах 


Если предполагается эксплуатировать систему Ео5$ коллективом разра- 
ботчиков, то для каждого участника проекта необходимо создать персональную 
учётную запись. Эта процедура очень похожа на предоставление доступа к ком- 
пьютерам, входящим в состав вычислительной сети. 

Когда компьютеры только начали объединять в простейшие сети для сов- 
местного использования принтеров и файлов, нередкой была ситуация, при ко- 
торой все участники разделяли одну и ту же учётную запись, обладающую 
обычно максимальными правами системного администратора. В небольших 
коллективах (как правило, полностью сосредоточенных в одном помещении и 
имеющих возможность непосредственного общения), где люди ответственно 
относятся к выполняемой работе, обладают достаточной квалификацией и мо- 
гут подменять друг друга для решения производственных вопросов, такой вари- 
ант использования имеет право на существование и по сей день. 

Совместное использование информационной системы большим коллекти- 
вом сотрудников может порождать две задачи. Во-первых, может представлять 
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интерес, какой именно пользователь совершил в системе те или иные действия. 
Во-вторых, в соответствии со своими обязанностями пользователи системы 
должны иметь разный уровень доступа к системе во избежание утечки конфи- 
денциальных сведений и для предотвращения нарушений нормального течения 
рабочего процесса из-за необходимости восстановления ошибочно удалённых 
данных. Кому-то достаточно только просматривать информацию, в обязанности 
другого входит создание новых записей, а третьему требуется иногда вносить 
изменения в существующие записи. 

Первая задача решается идентификацией всех пользователей информаци- 
онной системы путём назначения им персональных имён, под которыми они 
должны авторизовываться для получения доступа к её ресурсам. В дальнейшем 
любые действия конкретного пользователя могут регистрироваться в системных 
журналах, сопровождаясь отметкой об имени учётной записи, с использованием 
которой эти действия были совершены. 

Вторая задача решается перечислением операций, которые пользователь 
имеет право выполнять в информационной системе, и привязкой их к учётной за- 
писи пользователя. Операции, не входящие в список разрешённых, пользователь 
выполнить не сможет, и, таким образом, будет минимизирован вред, который тот в 
состоянии нанести своими умышленными или неумышленными действиями. 

Поскольку различных операций в информационных системах, как прави- 
ло, достаточно много, то перечислять разрешённые и запрещённые для каждой 
учётной записи утомительно. Кроме того, в ходе установки индивидуальных 
прав доступа легко допустить ошибку. К счастью, на практике пользователей 
информационной системы можно классифицировать по группам, члены кото- 
рых имеют схожие должностные обязанности, а значит, должны обладать оди- 
наковыми наборами прав для их выполнения. 

Тогда для раздачи полномочий реальным пользователям можно ввести 
промежуточное звено — виртуальных пользователей, по одному для каждой 
группы, выявленной в ходе анализа должностных обязанностей. Каждому вир- 
туальному пользователю скрупулёзно назначаются разрешения, необходимые 
для его нормальной работы. После этого остаётся лишь указать для каждого ре- 
ального пользователя, к какой группе он относится (какому виртуальному поль- 
зователю соответствует), для того чтобы применение детального набора прав 
доступа происходило автоматически. 

Описанный подход к разграничению доступа применяется практически во 
всех существующих информационных системах. Отличаются лишь терминоло- 
гия и детали реализации. Рассмотрим, как производится разделение прав поль- 
зователей в системе Ео$$1. 


3.6. Пользователи и категории 


Сначала выясним, какие понятия используются для управления правами 
пользователей системы ГРо$$1. О том, как осуществляется назначение прав на 
практике, поговорим немного позже. 
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В системе управления доступом Е0о5$ имеются четыре заранее настроен- 
ных виртуальных пользователя: 

® породу (никто); 

® апопутоиз (аноним); 

® геадег (читатель); 

® Че\уеорег (разработчик). 

В общих терминах управления доступом они олицетворяют группы, т. е. 
заранее сформированные списки разрешений, которые можно отображать на 
учётные записи реальных пользователей. В системе Ео$$Й эти виртуальные 
пользователи называются Саедогу (Категории). Познакомимся с ними поближе. 


Категория побоау 


К категории побоау относятся пользователи, попавшие на веб-страницу 
репозитория, но не авторизовавшиеся в системе путём ввода имени и пароля. 
По умолчанию такие пользователи имеют права на загрузку себе содержимого 
репозитория и чтение общедоступной информации: статей в подсистеме доку- 
ментирования (\\М1К1) и запросов на доработку (Т1ске6). 


Категория апопутоиз 


К категории апопутоиз относятся пользователи, которые не просто зашли на 
веб-страницу репозитория, но и авторизовались в системе под именем апопуточ$. 
Как было показано ранее, пароль для авторизации под этой учётной записью от- 
крыто сообщается на веб-странице с формой авторизации, поэтому такая реги- 
страция доступна для любого одушевлённого посетителя веб-страницы. 

По сравнению с категорией побо4у пользователи апопупои$ получают 
возможность глубокого погружения в репозиторий через имеющиеся на веб- 
страницах гиперссылки, создания и дополнения запросов на доработку, допол- 
нения статей документации. 

Основная цель введения категории апопупо$ в дополнение к категории 
пободу — защита содержимого репозитория от сетевых пауков и поисковых ро- 
ботов, которые сканируют сеть Интернет в автоматическом режиме для изуче- 
ния всей доступной информации. 


Категория геадег 


К категории геадег относятся зарегистрированные в системе пользователи, 
которым явным образом назначена эта категория. Принадлежность к этой кате- 
гории открывает возможность смены пароля своей учётной записи, корректи- 
ровки статей документации УЛ и запросов на доработку. 


Категория 4еуеорег 


К категории аеуеорег относятся зарегистрированные в системе пользова- 
тели, которым явным образом назначена эта категория. Пользователи, принад- 
лежащие к этой категории, получают право на отправку в репозиторий выпол- 
ненных ими изменений в файлах проекта, просмотр контактной информации 
других пользователей репозитория и авторов запросов на доработку, удаления 
записей, созданных анонимными пользователями в системах документирования 
и ведения заявок на доработку (право на борьбу со спамом). 
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Иерархия категорий 


Концепция категорий в Ео5$ очень похожа на концепцию групп при 
управлении правами в операционных системах. Но если опираться на эту ана- 
логию, то надо сразу отметить два важнейших отличия. 

Во-первых, в Е0$5Й нельзя создавать новые категории и приходится до- 
вольствоваться теми четырьмя, что перечислены выше. Учитывая ограничен- 
ный круг задач, которые решает система Ео$51 (по сравнению с операционной 
системой), на практике этого достаточно, тем более что существует возмож- 
ность модифицировать набор прав, назначенных категориям. 

Во-вторых, категории Роз; существуют не как самостоятельные сущно- 
сти, а уже выстроены в иерархию. Так, права категории пободу автоматически 
добавляются к правам категории апопутоиз, а права категории апопутоиз (уже 
дополненные правами категории породу), в свою очередь, автоматически назна- 
чаются категориям геааег и Чеуеюрег. При этом наборы прав, присущие только 
категориям геадег и деуеорег, не пересекаются между собой. 

Сказанное означает, что если при распределении прав пользователю при- 
сваивается категория геадег, то нет необходимости присваивать ему ещё и кате- 
гории пободу и апопутоиз — соответствующие разрешения будут добавлены ав- 
томатически. С другой стороны, при назначении пользователю категории 
Чеуерег, скорее всего, ему следует назначить и категорию геааег — в против- 
ном случае он не сможет, например, изменить пароль своей учётной записи. 


Владельцы и администраторы 


Как уже было сказано, при создании репозитория в нём автоматически со- 
здаётся единственный пользователь — владелец этого репозитория, который об- 
ладает по отношению к созданному репозиторию всей полнотой власти. Он мо- 
жет выполнять над репозиторием любые операции, а также создавать и удалять 
других пользователей. Помимо владельца в репозитории в качестве привилеги- 
рованных пользователей могут быть созданы пользователи-администраторы, ко- 
торым пользователь-владелец делегирует большую часть своих полномочий. 

Может возникнуть вопрос, благодаря чему учётные записи пользователей 
Ео5$П становятся обладателями привилегий? Дело в том, что помимо рассмот- 
ренных выше категорий, которым назначаются отдельные права из общего 
набора прав Ео$$1, существуют два привилегированных набора прав, детальный 
состав которых не раскрывается и не может быть изменён. Это как раз и есть 
набор прав владельца репозитория — Зеир изег — и набор прав администрато- 
ра — Аатт. 

Эти привилегированные наборы прав могут быть назначены пользовате- 
лям репозитория точно так же, как им назначаются категории. Основное их от- 
личие от категорий состоит в том, что наборы прав, входящие в их состав, не 
могут быть изменены. Из-за того, что список прав привилегированных наборов 
нельзя увидеть, непросто описать и их отличие. 

Если говорить кратко, то права владельца больше прав администратора. 
Поэтому в репозиториях небольших проектов в большинстве случаев можно 
обойтись без администраторов (права владельца могут быть назначены не- 
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скольким пользователям). Права администратора выдаются для того, чтобы 
пользователь мог: 

® управлять пользователями репозитория; 

® модерировать системы ведения документации и заявок на доработки, 
очищать их от спама; 

® выполнять рутинные административные процедуры, следить за состоя- 
нием репозитория. 

При этом надо понимать, что некоторые вещи остаются недоступными 
для администраторов, не являющихся владельцами репозитория. 

Подводя итог, можно сказать, что управление пользователями в Е0531 со- 
стоит из двух этапов: 

1) создание учётной записи пользователя; 

2) передача прав созданному пользователю одним из следующих способов: 

® назначение ему категорий; 

® назначение ему привилегированных наборов прав; 

® назначение ему индивидуальных прав из набора Е0$$1. 

Пришло время разобраться, как это осуществляется на практике. 


3.7. Управление пользователями 


Управление пользователями в Ео$$ осуществляется через веб-интерфейс. 
Чтобы открыть необходимую для этого панель, надо выбрать в главном меню 
пункт Аатт, после чего перейти по гиперссылке Цзег$ (Пользователи) (рис. 3.7). 
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Рис. 3.7 


Вызов панели управления пользователями через пункт меню Аатт | Цзегз 
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Внешний вид панели управления пользователями показан на рисунке 3.8. 
Она состоит из двух таблиц. В верхней части находится таблица категорий. Она 
содержит четыре строки — по одной для каждой из рассмотренных выше кате- 
горий. 
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Рис. 3.8 
Панель управления пользователями 

В первом столбце Саедогу (Категории) отображаются названия категорий. 
Они представлены гиперссылками, при переходе по которым открывается веб- 
страница, на которой перечислены права доступа Ео$31. Возле каждого разре- 
шения на ней имеется флажок, установка которого означает включение его в 
набор соответствующей категории. 

Откроем, например, панель настройки категории геадег (рис. 3.9). В её 
верхней части отображается Цзег 12 — идентификатор пользователя (для катего- 
рии геааег он равен 5) — и Еодт — имя виртуального пользователя категории 
(в приведенном примере рассматривается категория геадег). 

Центральная часть панели занята списком разрешений Сараб!Мез, из ко- 
торого отмеченные флажком включаются в набор прав для настраиваемой кате- 
гории. Рядом с названиями некоторых разрешений на месте нижнего индекса 
записаны цветные буквы латинского алфавита. Они сигнализируют, каким кате- 
гориям назначены эти разрешения: М — пободу, А — апопутоиз, В — геадег, 
О — деуаорег. 
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Рис. 3.9 
Панель настройки категории 


В поле Заецщеа Сар (Выбранные возможности), которое находится под 
списком разрешений, отображается строка символов, в краткой форме пред- 
ставляющая выбранные для настраиваемой категории разрешения. В приведен- 
ном примере это Кр: К — \М\Ще-\ММК! (написание в Вики), р — Раззмога (изме- 
нение пароля), { — Веройз$ (создание нового формата отчёта), \м — М/\е-Тске! 
(редактирование заявки на доработку). С помощью гиперссылки Кеу, размещён- 
ной рядом с полем Заесед Сар, можно открыть справочник разрешений Ко3$1|, 
в котором приведены расшифровки значений каждого символа, входящего в 
назначенные разрешения. 

В нижней части панели настройки категории находятся кнопки Арру 
СКапдез (Применить изменения) и Сапсе! (Отменить). Если покинуть веб- 
страницу панели без нажатия кнопки Арру Свапдез, то внесённые изменения не 
будут сохранены. 
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Вернёмся к панели управления и продолжим рассмотрение таблицы кате- 
горий. Во втором столбце Сараб!ез (Возможности) отображаются строки сим- 
волов, которыми кодируются права Ео3$1, включённые в набор прав соответ- 
ствующей категории. О том, как формируются эти строки, только что было рас- 
сказано. Рядом с названием заголовка столбца находится гиперссылка Кеу 
(ключ), по которой открывается справочник с полным перечнем прав. 

В третьем столбце тю (Информация) отображаются описания перечис- 
ленных в таблице категорий. Из него можно узнать о том, что категория Мободу 
назначается всем посетителям веб-страницы проекта, категория Апопутои$ — 
всем пользователям, которые авторизовались посредством имени и пароля, а ка- 
тегории Веадег и Оеуеорег присваиваются пользователям с помощью символов 
ци у соответственно. 

Четвёртый столбец Ёаз{ Спапде (Последнее изменение) должен, вероятно, 
заполняться датой и временем последней модификации прав соответствующей 
категории. Однако в версии Ео$31 2.9 для \Ип4о\з он остаётся пустым, из чего 
можно сделать вывод, что этот атрибут является зарезервированным. 

В нижней части панели управления находится таблица пользователей. 
Новый репозиторий имеет единственного пользователя — его создателя и вла- 
дельца, поэтому в таблице только одна строка. 

В первом столбце Ёодт Мате (Имя входа в систему) отображается имя 
пользователя, которое используется на веб-странице авторизации совместно с 
паролем. Оно представлено гиперссылкой, при переходе по которой открывает- 
ся панель настройки пользователя (рис. 3.10). 

Панель настройки пользователя похожа на панель настройки категории. 
Поскольку учётные записи пользователей Ео$5 определяются своими иденти- 
фикаторами Цзег 0, имя входа в систему 1одт можно изменять. В новом поле 
Сотас! тю (Контактная информация) можно указать дополнительные сведения 
о пользователе, в частности — адрес электронной почты. 

Так же как и на панели настройки категорий, присутствует полный пере- 
чень разрешений Сараб!ез. Его возглавляют привилегированные наборы Зер 
и Аадтт, за которыми следуют категории Веадег и Оеуеорег. В большинстве 
случаев этих пунктов достаточно для установки разрешений конкретному поль- 
зователю. Но при необходимости можно передать пользователю в индивидуаль- 
ном порядке дополнительные права из основной части списка. 

В поле Разз\мога (Пароль) можно изменить пароль учётной записи пользо- 
вателя, который будет использоваться для входа в систему. 

В отличие от категорий, список которых не может быть изменён, учётную 
запись пользователя можно удалить. Для этого предназначена кнопка Веве Цзег 
в нижней части панели. 

Вернёмся к панели управления и продолжим рассмотрение таблицы поль- 
зователей. Во втором столбце Сар$ (Возможности) отображается перечень прав, 
представленных условными символами. 

В третьем столбце тю (Информация) отображаются сведения, введённые 
в поле Сощас! тю панели настроек. 
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Рис. 3.10 
Панель настройки пользователя 


В чётвёртом столбце Вае отображаются даты создания учётных записей 
пользователей. В дальнейшем они будут заменяться датами внесения последних 
изменений в карточки пользователей. 

Пятый столбец Ехрие (Срок годности), исходя из его наименования, дол- 
жен содержать даты, после которых учётные записи становятся недействитель- 
ными. Однако в настоящее время отсутствует возможность указания этих дат 
через веб-интерфейс. 
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В шестом столбце Ёаз{ Еодт (Последний вход в систему) будет отобра- 
жаться время, прошедшее с момента последней успешной авторизации пользо- 
вателя в системе. 


3.8. Добавление и удаление пользователей 


Для создания учётной записи нового пользователя надо воспользоваться 
пунктом Ада (Добавить) дополнительного горизонтального меню, имеющегося 
на панели управления пользователями (рис. 3.11). 


5итре зта!е-раде ммебзйе: /5ег! Ж 


= с ®@ © О осапозЕ 808 б/зетир_ип1 «я ю® в 


эитр!е зэтае-раде меь$Ке / о. зари — овом 


= Ноте Титештпе „ее Вгапспез Адгт 


Еодит Мате +|Сарз | тво Оаке + Ехрие +25 Годйп + 
[берувег 5 [О 


Рис. 3.11 
Вызов панели добавления пользователя 


Многие элементы панели добавления пользователя, которая показана на 
рисунке 3.12, уже знакомы по описанию панели настройки пользователя, кото- 
рая была подробно рассмотрена выше. Числовой идентификатор учётной запи- 
си нового пользователя будет назначен системой автоматически. Для создавае- 
мого пользователя достаточно указать его имя в системе (109), контактную 
информацию (Сотас! пЮ), отметить предоставляемые права (СарабИез), вве- 
сти пароль (Разз\ога) и нажать кнопку АррУу Спапдез. 

В приведённой на рисунке 3.12 форме создаётся пользователь с именем 
|прозег1 (первый верстальщик) с адресом электронной почты итр1 @Ю3з$1.зегуег. 
Поскольку работа верстальщика подразумевает модификацию НТМГ- и С$$- 
файлов, составляющих исходный код веб-страниц, он должен иметь возмож- 
ность отправлять результаты своей работы в репозиторий. Такие права ему 
предоставляет принадлежность к категориям ВНеаадег и Оеуеорег. 
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Рис. 3.12 
Панель добавления пользователя 

Предположим, что над проектом по разработке веб-страницы будут тру- 
диться два верстальщика и два веб-дизайнера. Дизайнеры предоставляют вер- 
стальщикам макет веб-страницы в виде изображения, а также разрабатывают 
визуальные элементы в виде изображений, записанных в 21{- и рее-файлах. 
Верстальщики по полученному от дизайнеров макету пишут НТМГ- и С$5-код, 
который с использованием визуальных элементов обеспечит отображение раз- 
рабатываемой веб-страницы в браузере. 

Создадим учётные записи верстальщиков |трозег1 и !трозег2 и дизайне- 
ров Везюпег1 и Оезюдпег? с правами на изменение содержимого репозитория. 
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Кроме того, создадим учётную запись для менеджера проекта Мападег с права- 
ми администратора по отношению к репозиторию. Регистрационные данные 
(имя и начальный пароль) следует передать пользователям с рекомендацией из- 
менить пароль на новый как можно быстрее при первом же сеансе работы в си- 
стеме. 

В результате проделанной работы таблица пользователей репозитория 
должна принять вид, показанный на рисунке 3.13. Из неё видно, что пользова- 
тель Оез!дпе!1 уже воспользовался полученными регистрационными данными и 
десять минут назад успешно авторизовался в системе. 
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Рис. 3.13 
Заполненная таблица пользователей на панели управления 
Может оказаться, что два дизайнера на таком небольшом проекте — не- 
позволительная роскошь. В таком случае список пользователей придётся под- 
корректировать. 
Во-первых, нужно удалить учётную запись второго дизайнера. Для этого 
надо открыть карточку удаляемого пользователя, перейдя по гиперссылке с его 


именем в столбце Годт Мате таблицы Цзегз на странице управления учётными 
записями (рис. 3.14). 
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Рис. 3.14 
Открытие карточки пользователя 

Затем в нижней части формы с параметрами учётной записи надо нажать 
кнопку Ое@е Цзег (Удалить пользователя). Над кнопками отобразится запрос на 
подтверждение удаления. Надо поставить флажок в поле Сопёгт аеще (Под- 
твердить удаление) и ещё раз нажать кнопку Беве Цзег (рис. 3.15). 

Точно так же можно удалить и учётную запись первого дизайнера, а по- 
том создать новую — для единственного дизайнера проекта. А можно подкор- 
ректировать существующую учётную запись. Для этого надо открыть карточку 
пользователя Оез!дпег1, как только что было описано, после чего вписать в неё 
имя пользователя Оез!юпег и адрес электронной почты аездпег@Юз51.зегуег. 
Будет не лишним изменить пароль учётной записи. Для сохранения внесённых 
изменений осталось нажать кнопку Арру СпПапдез (Применить изменения) 
(рис. 3.16). 
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Рис. 3.15 
Удаление пользователя 
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О рее © Уме МИКид) = Бомтоаа 2 м] 
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Я Сюпем ЕпаЫе Оебид 
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Мету: М Сопйтп Баве — Снеск4НЕь Бох апа ргезз "ее зег” адат 
| Арру Свапдез | | аме сд ] 


Рис. 3.16 
Изменение учётной записи 
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В окончательном варианте команду проекта Простой одностраничный 
веб-сайт будут составлять четыре сотрудника (рис. 3.17): 

® менеджер — Мападег; 

® первый верстальщик — |трозег1; 

® второй верстальщик — трозег2; 

® дизайнер — Оезопег. 


Узегз 


ГСооти Мате +353 Ц №  [ быеф [Ехрие ®таьиьовля +] 
Резо" [м  [@езопетаюзейвемег[р020-025] | | 
итр1 @05$5$1.зегуег 2020-02-29 | 13.3 дауз 


ипр2@иоззИ зегиег _ 2020-02-29] 
|Мападег _ |а _ |тог@юзэйзегег _ |2020-03-01| [80.0 тишез 
емрузе в | [0200301 [162 уз 


Рис. 3.17 
Окончательный список пользователей системы Ео55И 


На этом подготовительный этап можно считать завершённым. Пора при- 
ступать к реальной работе над проектом. 
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Глава 4 
СИСТЕМА КОНТРОЛЯ ВЕРСИЙ 


4.1. Начало совместной работы 


4.1.1. Индивидуальные рабочие места 


К настоящему моменту файл репозитория проекта «Простой одностра- 
ничный веб-сайт» создан и размещён на сервере, в репозитории заведены учёт- 
ные записи участников проекта и к нему предоставлен сетевой доступ. Одним 
словом, всё готово для работы над проектом. Но как должен происходить рабо- 
чий процесс? 

Работа над веб-сайтом представляет собой написание текстов на языках 
НТМЕ и С$$ и создание файлов с графическими элементами. Как правило, 
процесс этот итерационный и заключается в цепочке последовательных улуч- 
шений. 

Это значит, что в рабочие материалы вносятся относительно небольшие 
изменения, решающие какую-то одну небольшую задачу, после чего оценивает- 
ся получившийся результат. Если этот результат удовлетворительный, то реша- 
ется очередная задача. В противном случае сделанные изменения отменяются, и 
осуществляется второй подход к той же задаче с учётом полученного опыта. 

Изюминку в описанный процесс разработки вносит то, что над одним и 
тем же проектом одновременно работает несколько специалистов. И не всегда 
работу удаётся распределить таким образом, чтобы изменения, вносимые ими в 
проект, не пересекались. Если дизайнеры трудятся каждый над своим графиче- 
ским элементом (например, один разрабатывает изображение логотипа, а вто- 
рой — фоновое изображение), то верстальщики могут одновременно вносить 
изменения в одни и те же НТМГ-файлы. 

Менеджера проекта могут интересовать рабочие материалы в текущий 
момент времени, чтобы контролировать прогресс, вовремя замечать возникаю- 
щие затруднения и оценивать степень готовности продукта. 

Система Е05$ позволяет упростить взаимодействие и решить множество 
проблем, возникающих по ходу разработки. Но для её использования помимо 
серверной части необходимо настроить индивидуальные рабочие места всех 
участников проекта. Эта настройка заключается в выполнении двух действий: 

® клонирование сетевого репозитория в локальный (требуется только при 
использовании сервера Е0$$1|); 

® создание рабочего каталога (требуется в том числе и при локальной 
разработке). 

Создание индивидуального рабочего места выполняется только один раз в 
ходе подготовки к работе над проектом. В результате получается структура, 
изображённая на рисунке 4.1. 
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Сервер Ео$$Й 


зэрмеб$Не.№о$$1 


шаех. Пт! 
шп4ех.с$$ 


Рис. 4.1 
Схема развёртывания проекта, управляемого Ео55И: 


цилиндрами изображены файлы, имеющие структуру базы данных ЗОГ ие. Стрелками указа- 
ны зависимости элементов. 


Файл сетевого репозитория на сервере называется ззрмебзИе1озз1. В ре- 
зультате его клонирования на рабочем компьютере участника проекта создаётся 
файл ззрмебзЦе-юса!10$$Й, содержащий локальную копию сетевого репозитория. 
При организации рабочего каталога проекта мебзйе в нём создаётся файл 
_РОЗЗ!Ё_ (в операционной системе \!т4о\$) или 15 сКоШ (в других операцион- 
ных системах). 

Важно помнить, что локальные элементы, в отличие от серверного репо- 
зитория, содержат привязки к своим источникам: файл локального репозитория 
помнит, из какого сетевого репозитория он был клонирован, а рабочий каталог 
помнит путь к своему локальному репозиторию. Эти связи могут нарушаться 
при перемещении файлов, и тогда потребуется их восстановление. 

Рассмотрим подробно этапы организации индивидуального рабочего ме- 
ста. 


4.1.2. Локальный репозиторий 


Первое, что необходимо сделать участникам разработки, —_ это получить 
свою копию репозитория проекта. Такая операция называется клонированием. 
Раньше уже говорилось о том, что репозиторий Ео$$ хранится целиком в одном 
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Гоз$-файле, который можно копировать на любые компьютерные системы. Од- 
нако такой вариант получения репозитория не годится для совместной работы, 
потому что копия файла ничего не будет знать о сервере разработки и будет 
считать именно себя корневым узлом. 

При клонировании репозитория важно понимать, от имени какого пользо- 
вателя выполняются действия и какие регистрационные данные используются. 
По умолчанию команда №351 использует имя учётной записи пользователя опе- 
рационной системы. Это не тот пользователь, который был зарегистрирован в 
сетевом репозитории в качестве участника работы над проектом. 

Поскольку в ходе клонирования устанавливаются доверительные отноше- 
ния между сетевым и локальным репозиториями, которые будут в дальнейшем 
многократно использоваться, лучше на этом этапе проявить максимальную ак- 
куратность и педантичность в указании регистрационных данных, чем потом 
кропотливо разбираться с причинами, по которым репозитории не синхронизи- 
руются. 

Правильный подход к получению копии репозитория проекта состоит в 
выполнении команды: 


Ео$$11 с1опе ВЕр://Тирозег1@зетуег.Ео$$11:8081/ ззриебз1Ее-1оса1.ЁЕоз$11 


В команде клонирования наряду с адресом сервера указывается имя поль- 
зователя для НТТР-авторизации, поэтому адрес запроса к серверу Ео$$1 выгля- 
дит так: ВЁр:/Лтрозег1 @зегуег.10$$1:8081/, где !трозег1 — имя учётной записи 
участника проекта. После адреса сетевого репозитория указывается имя файла 
для хранения локальной копии репозитория — ззрмебзйе-юоса!/ю$$1. Если всё 
было сделано правильно, то программа клонирования сначала запросит пароль 
указанного в адресной строке пользователя: 


раззмога Еог Тирозе!1: 


После того, как пароль будет введён, появится запрос подтверждения на 
сохранение пароля для доступа к сетевому репозиторию: 


тететрек раззмока (У/п)? 


Если отказаться от сохранения пароля (для этого с клавиатуры надо вве- 
СТИ М), то в последующем придётся набирать его для выполнения любых дей- 
ствий, затрагивающих сетевой репозиторий. Причём после каждого такого дей- 
СТВИЯ будет предлагаться пароль сохранить. Поэтому, если нет каких-то особен- 
ных причин для отказа, его лучше сохранить, для чего ввести с клавиатуры У 
либо просто нажать клавишу Емег (сохранение пароля подразумевается по 
умолчанию). 

Клонирование репозитория сопровождается выводом примерно такого 
информационного блока: 
Воипа-Ег1рз: 2 АкЕ1Еас®з зепе: 0 гесе1уеа: 7 
*** сте зкем *** зегуег 15$ $1ом Бу 19.2 ш1лпофез 
СТопе аопе, зеп®: 570 геселуеа: 1409 1р: 192.168.56.101 
Вери1191п49 героз1еогу шеба-аафа... 
100.0% сомр1ефе... 
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Ехекга Ае16а сопргкез$1оп... 

Уасиии1па ЕБе Чафаразе... 

рго]есЕе-1а: 53е4е1445Ер2а7289ер1а337се1сЕ8с9а99Е7Ъ86 
зехуег-1Аа: 849Е995271еа3Е0срЕ7191е8 660558636ЕаЕ2а2са 
аЯ@п1п-изек: Тирозег1 (раззмога 15 "Есеа64") 


Он напоминает сообщение, которое было получено при создании №Ю5$1- 
файла с новым репозиторием. Как и в том случае, в последней строке сообща- 
ется имя создателя — владельца репозитория (1трозег1) и его пароль ({сеаб4). 
Для локального репозитория эти сведения не являются важными, поскольку до- 
ступ к панели управления локальным репозиторием при необходимости можно 
получить с помощью команды Ю5$1 и! без авторизации. 

Во второй строке «*** те зКе\ *** зегует 1$ $1о\ Бу 19.2 шициез» сооб- 
щается о том, что часы сервера отстают на 19,2 минуты от часов рабочей стан- 
ции. Это плохой признак, поскольку при контроле изменений отметки времени 
являются важным фактором сравнения файлов. Чтобы в работе системы кон- 
троля версий не возникало нарушений, часы на компьютерах всех участников 
проекта должны быть синхронизированы. В современных компьютерных сетях 
поддержание точного времени на часах обычно не представляет трудности. 

Если регистрационные данные пользователя сетевого репозитория (его 
имя или пароль) были указаны неправильно, то в информационном блоке будет 
выведена строка: Еитог: юдт айеа (Оптибка: не удалось авторизоваться), а по- 
следней строкой будет сообщение: зегуег гейигте4 ап еггог - сюпе аБбоцеЧ (сервер 
вернул ошибку — клонирование прервано)». 

Может возникнуть вопрос: что произойдёт, если пароль быль введён с 
ошибкой, но при этом было подтверждено его сохранение? Как будет происхо- 
дить дальнейшая работа с репозиторием? На самом деле, ничего непоправимого 
не случится. Пароль запоминается в локальном репозитории, а при неправиль- 
ном вводе пароля авторизация в сетевом репозитории завершится неудачей, и 
локальный репозиторий просто не будет создан. Чтобы решить проблему, надо 
просто выполнить команду ещё раз с правильным вводом пароля. 

Если файл локального репозитория уже существует, то выполнение ко- 
манды не приведёт к его перезаписи. Вместо этого будет выведено сообщение 
об ошибке: 


Е11е а1хеаЧу ех1$Е$: з5рмерз16Ее-1оса1.ЁЕо$$11 
Ошибкой завершится и команда, в которой указан неправильный путь к 


сетевому репозиторию (например, вместо номера порта 8081 ошибочно указан 
порт 8080): 


саппоЕ соппесЕ Фо Бозе ЁЕо$з$11.зекуек: 8080 
С1опе аопе, зепе: 0 гесефуея: 0 1р: 


зекуег гебагкпеЯ ап егког - с1опе арогфеа 


Такое же сообщение будет выдано в случае, если попытка доступа к сер- 
веру Роз пресекается брандмауэром. 
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Файл, полученный в результате клонирования сетевого репозитория, не 
является точной копией №531-файла, размещённого на сервере. Во-первых, он 
содержит привязку к родительскому репозиторию, что позволит в дальнейшем 
выполнять синхронизацию рабочих материалов. Во-вторых, при клонировании 
не копируется секретная часть исходного репозитория, например пароли поль- 
зователей. В силу второй особенности клонирование сетевых репозиториев не 
считается действием, требующим особенных полномочий, и доступно даже для 
анонимных пользователей, желающих познакомиться с проектом. 

Отметим, что пользователь !трозег1 — владелец локального репозитория, 
несмотря на то, что получил при клонировании такое же имя, как и пользова- 
тель сетевого репозитория — участник проекта, является совершенно самостоя- 
тельной сущностью. Он не имеет никакой связи с сетевым репозиторием. 


4.1.3. Смена пароля 


При эксплуатации автоматизированных компьютерных систем обычной 
процедурой является периодическая смена паролей пользователей. Замену па- 
ролей может инициировать администратор системы в рамках реализации поли- 
тики информационной безопасности, либо пользователь может сам пожелать 
сменить пароль, если у него есть подозрение в его компрометации. 

Изменить свой пароль пользователь может через веб-интерфейс Ео$$И. 
В приведенном примере для этого потребуется запустить веб-браузер и набрать 
в адресной строке ОВГ.: НЯр:/№о$$1.зегуег:8081/. После авторизации надо перейти 
на страницу выхода из системы по гиперссылке 1ю090щ, находящейся в правом 
верхнем углу веб-страницы (рис. 4.2). 


= О х 
© тре этаЕ-раде мебзИе: 1050 Хх + 


< с А Не защищено | #0$$1.5егуег:8081 Лодт & хх © 


тре зэтае-раде ме з$Ке / тоотлодом 


— Ноте Птейпе Ее$ Вгапспез 
Ситепйу 1099е9 т аз !трозег1 Годок Фа 


Спапде Разз\мога ог изег Нтрозег1 


ОЧ Разз\ога: | зежеееее 


Мем/ Раз5\ога: | эеоофффое 


КБереа! Мем/ Раз5\/ога: | эфоффофое 


Спапде Раззмог4 = 


Рис. 4.2 
Смена пароля пользователя сетевого репозитория 
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На открывшейся веб-странице наряду с кнопкой 10904 находящейся в 
центре и предназначенной для выхода из системы, присутствует форма смены 
пароля. В поле О разз\мога надо набрать действующий пароль пользователя, в 
поле Мем раззмога — новый пароль, а в поле Ререа! Мем Разз\мога — повторить 
ввод нового пароля. Затем надо нажать кнопку Спапде Разз\мога. 

Если действующий пароль в первом поле был набран с ошибкой, то в цен- 
тре веб-страницы отобразится красный текст: Уои етеге4 ап шсогес! о!4 раззмога 
мпИе аНетрипа 10 свапде уоиг разз\мога. Уоиг разз\мгога 15 ипсрапдеа (Вы ввели не- 
правильный старый пароль при попытке изменения вашего пароля. Ваш пароль 
не был изменён), и смены пароля не произойдёт. 

Если введённые в нижних двух полях пароли не совпадают, то в центре 
веб-страницы отобразится красный текст: ТВе Мю сорез оЁ уоиг пем разз\/ога$ 40 
по! пан. Уоиг раззмога 15 ипспапдеа (Две копии нового пароля не совпадают. 
Ваш пароль не был изменён), и смены пароля не произойдёт. 

В случае успешной смены пароля произойдёт переход на домашнюю веб- 
страницу проекта. И ситуация в этом случае будет выглядеть следующим обра- 
зом: учётная запись на сервере имеет новый пароль, а в регистрационных дан- 
ных локального репозитория содержится старый пароль. Из-за этого информа- 
ционный обмен между локальным репозиторием и сервером станет невозмож- 
НЫМ. 

Чтобы обновить пароль учётной записи в локальном репозитории, потре- 
буется выполнить команду: 


Еоз$11 гемобе ВЕЕр://Тирозег1@Ео0о3$11.зекуег: 8081 


Эта команда предназначена для изменения ОКГ, по которому доступен 
сетевой репозиторий, и может оказаться полезной при переносе сетевого репо- 
зитория на другой сервер. Но даже если выполнить её с тем же ОВГ, который 
был указан при клонировании репозитория, она приведёт к запросу и измене- 
нию пароля учётной записи в локальном репозитории. После ввода пароля сно- 
ва будет задан вопрос о его сохранении для дальнейшего использования, а в 
конце будет выведен установленный ОВГ: 


раззмога Еог Тирозег1: *** гещшешрег раззмога (У/п)? у 
БЕЕр://Тирозег1@Е0$$511.зегуег:8081 

Проверить взаимодействие локального и сетевого репозитория проще все- 
го с помощью команды их синхронизации: 
Ео$$11 зупс -В з5рмерз1ее-1оса1.Ео$$11 

Посредством параметра -К указывается имя файла локального репозито- 


рия, для которого должна быть выполнена синхронизация с его сетевым источ- 
ником. При отсутствии ошибок на экран будут выведены строки: 


бупс м1ЕБ БЕфр://Тирозег1@Ео$$11.зегуег:8081 
Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 
Зупс аопе, зепе: 539 гесе1уеа: 415 1р: 192.168.56.101 
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Если же пароли не совпадают, то в выводе команды появится строка 
«Етгот: 1оэт Пед» (Ошибка: авторизация неудачна): 


бупс мфЕН БЕ фр: //Гирозех1@Ео$511.зекуег: 8081 
Коипа-Е:1рз: 1 АкЕ1Еасе5 зепе: 0 гесефуеа: 0 
Еггог: 10911 Еа11еа 


Коппа-&:1рз: 1 АгЕ1Еасе$ зепе: 0 геселуеа: 0 
Зупс аопе, зепе: 539 гесе1уеа: 300 1р: 192.168.56.101 


4.1.4. Рабочий каталог 


Получение локальной копии сетевого репозитория — это первый этап ор- 
ганизации индивидуального рабочего места. Работа над проектом подразумева- 
ет создание и изменение составляющих его файлов, для чего могут использо- 
ваться различные инструменты: графические и текстовые редакторы, интегри- 
рованные среды разработки, системы автоматизированного проектирования 
ит. п. В подавляющем большинстве все эти инструменты не умеют работать с 
Гоз$]-файлами напрямую, а значит, не могут увидеть в них содержимое репози- 
тория. 

Поэтому следующим шагом в организации рабочего пространства являет- 
ся извлечение файлов проекта в рабочий каталог файловой системы на компью- 
тере участника проекта. Но простая распаковка, как, например, в случае 7ЛР- 
архива, здесь тоже не годится, потому что в дальнейшем между репозиторием и 
рабочим каталогом будет регулярно происходить двухсторонний информацион- 
ный обмен. Для упрощения этого взаимодействия необходимо сохранить связь 
между репозиторием и его рабочим каталогом. 

Чтобы извлечь содержимое репозитория в рабочий каталог, необходимо: 

1) создать рабочий каталог; 

2) сделать рабочий каталог текущим; 

3) открыть репозиторий из рабочего каталога. 

Перечисленные шаги реализуются следующей последовательностью ко- 
манд операционной системы: 


пка1к мерз1ее 
са мерз1Ее 
Ео$5$11 ореп ..\ззриерз1е-1оса1.о0$5$11 


Если команды набраны верно, то в результате выполнения последней бу- 
дет выведено сообщение: 


рго]есе-паме: $1тр1е °з1п91е-раде мерз1е 

тероз1фогу: (...)/Еоз$11/мерзлее/.. \ззрмерз1Ее-1оса1.Е0$5$11 
1оса1-коое: (...) /Еоз$11/мерз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ро$511 
рго]есе-соае: 53е4е1445Е52а7289еЪ1а337се1сЕ8с9а99Е'7р86 
срескойе: 24е23с5сЕбора7ре781аба 8 6е7аас8е12е9сас4 2020-02-29 
07:24:50 ОТС 

фачз: ЕгипК 

сопмепе: 1п0161а1 ешрЕу спеск-1п (азег: бебир0Озег) 

среск-11$: 1 
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В первой строке сообщается название проекта, во второй — путь к файлу 
репозитория, который использован в качестве источника файлов проекта, в тре- 
тьей — путь к рабочему каталогу. В контексте файловых систем следует пом- 
нить о том, что в операционных системах семейства Ошх в качестве разделите- 
ля элементов пути к файлу используется символ слеш /, а в операционных си- 
стемах семейства \Ипдо\у$ — обратный слеш \. 

После открытия репозитория в рабочем каталоге проекта появится файл с 
именем _РОЗ$З!Ё_ (в операционной системе \190о\з$) или ской (в других 
операционных системах). Он, как и файл №$5П-репозитория, имеет структуру 
базы данных ЗОГЁе. В нём содержатся сведения о состоянии файлов проекта в 
рабочем каталоге и привязка к файлу локального 055-репозитория. 


4.1.5. Загрузка файла в репозиторий 


На текущий момент у нас имеется сетевой репозиторий, размещённый на 
сервере. Один из участников проекта — верстальщик с именем трозег1 учёт- 
ной записи в системе Ео5$ — уже получил локальную копию сетевого репози- 
тория и создал рабочий каталог для файлов проекта. Действия по настройке ин- 
дивидуальных рабочих мест следует произвести и остальным участникам про- 
екта — второму верстальщику 1трозег2, дизайнеру Оез!опег, а также менеджеру 
Мападег. 

А пока они это делают, первый верстальщик, дабы не терять зря времени, 
решил приступить к работе над проектом. В своём рабочем каталоге он создал 
файл таех.Пт, содержащий стандартный скелет веб-страницы: 


Листинг таех.йт 


<Вем1> 
<Веаа> 
<6161е>51ир1е з1па1е-раде мерз16е</&1Е1е> 
</веаа> 
<Боду> 
<В1>Простой одностраничный веб-сайт</61> 
</Боау> 
</ВЕт1> 


Как теперь поделиться своей наработкой с коллегами? Надо загрузить со- 
зданный файл в репозиторий, чтобы его оттуда могли получить все желающие. 
Но рабочий процесс в Еоз$ построен так, что требуется явным образом ука- 
зать, какие файлы из рабочего каталога являются частью проекта. Сначала мож- 
но выполнить команду, которая покажет, какие файлы ещё не включены в про- 
ект: 


Ео$$11 ехегаз 


Для приведенного примера будет выведено имя единственного файла: 
шаех.Н ат. 

При выполнении команды обязательно должен быть текущим рабочий ка- 
талог проекта, содержащий файл _РОЗЗ!_ (или 15сКоц). Если это не так, то на 
экран будет выведено сообщение об ошибке: ситеп{ атесюгу 15 по{ мИйт ап ореп 
спескоц (текущий каталог не внутри открытого проекта). 


62 


Добавим файл тдех.Ит! в проект: 
05511 аа 1паех.ВЕт1 


Если всё было сделано верно, то на экране появится сообщение: АВОЕБ 
шаех.пит! (добавлен ш4дех.В т). Если же в имени добавляемого файла была до- 
пущена ошибка, то появится сообщение: поЁ Ююипа: ...Лмебзелтах. т! (не 
найден: .../\ебзцели их .Вит]). 

Выполненная команда никак не изменила состояние ни локального, ни се- 
тевого репозитория. Она просто включила файл таех.Мт! в список тех файлов, 
за которыми должна наблюдать система контроля версий. Теперь можно по- 
смотреть состояние рабочего каталога: 


Еоз311 збабаз 


Команда выведет на экран примерно такой текст: 


тероз1огу: .../мерз1ее/.. \ззриебз1Ее-1оса1.Ео0$$11 
1оса1-кооё: .../мерз1е/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ро$511 

срескойе: 24е23с5сЕбора7ре781аба 8 6е7аас8е12е9сас4 2020-02-29 
07:24:50 ОТС 
Тачз: ЕгипкК 


сопмепе: 10161а1 ешрЕу спеск-1п (азег: бебир0Озег) 
АБОЕР 1паех.6 м1 


В последней строке сообщается о том, что система Ео$$Й приняла на кон- 
троль файл паех.Нт!. Эту же информацию можно получить в более компактном 
виде, без строк заголовка, с помощью команды: 


Еоз5$11 срапаез 


Наступил ответственный момент. Загрузим файл тдех.Вт! в репозиторий, 
для чего выполним команду: 


Ео$$11 соши1е 


Начнётся процесс записи изменений в репозиторий, сопровождающийся 
выводом информационных сообщений: 


Апбозупс: Вер: //Ттрозег1@Ео5$11.зекхуег: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еасе5 зепе: 0 гесе1уеа: 0 
Ро11 аопе, зепе: 431 геселуеЯ: 338 1р: 192.168.56.101 


На экране монитора появится окно текстового редактора с предложением 
ввести описание изменений, которые в настоящий момент вносятся в проект 
(рис. 4.3). 

После ввода описания изменений, которое должно быть кратким, но со- 
держательным (в приведенном примере это текст «Добавлен НТМЁ-шаблон 
пдех.п{тЪ»), надо выполнить сохранение в текстовом редакторе (в Блокноте до- 
статочно нажать СШ + $5) и завершить его работу (в \т4о\/$ — с помощью ком- 
бинации клавиш АК + Е4). 
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#й ^ ‹-соплтеп{-9С78184Е7АА8 - Блокнот 


Файл Правка Формат Вид Справка 

Добавлен НТМЕ-шаблон шадех.Р т! 

# Епфек а сопш1Е шеззаде Ёок %В1$ свеск-1п. 
Т1пез Юед1пп1пд м1ЕВ # аке 1дпогеа. 

= 
# чзек: Гарозек1 
# садз: екарк 

= 
# АШРЕР 1п4ех.В 61 


Рис. 4.3 


При загрузке изменений в репозиторий предлагается ввести описание изменений 


В операционной системе \Ут4о\$ может быть выведено предупреждение 
о том, что добавляемый в репозиторий файл содержит двухсимвольные перено- 
сы строк СВ/СЕ, за которым последует запрос подтверждения на сохранение его 
в таком виде: 
./1паех.м1 сопЕа1пз СВ/ЪЕ 11пе епЯ1па$. зе --по-магп1п95 ог Ве 


"сЕ1Е-а1ор" зеЕЕ1па Во Я91заЪ1е {61$ магп1па. 
Сопм1Е апуВом (а=а11/с=сопуег®/у/М)? у 


В ответ на этот запрос надо ввести символ «у» с клавиатуры для разреше- 
ния использования такого формата текстовых файлов. Процесс загрузки файла в 
репозиторий будет продолжен с выводом на экран информационных сообще- 
ний: 
Мем Уегз1оп: 
а8е5а7176с098=320а19а1с63е7585с8адеЪ80+еабсь2а535е059е4821Е68аса 
Апбозурс: Вер: //Ттрозег1@Ео$$11.зекуег: 8081 / 
Воипа-Ег1рз: 1 АкЕ1Еасе5 зепе: 2 геселуеа: 0 
бупс Аопе, зепе: 810 гесе1уеа: 416 1р: 192.168.56.101 


Если теперь посмотреть состояние рабочего каталога с помощью команды 
0551 зав$, то в последней строке будет выведено описание последнего выпол- 
ненного изменения с указанием пользователя, который его произвёл: 


героз16огу: .../Еоз811/мерз1Ее/. .\ззримерз1ее-1оса1.Ёоз$11 
Тоса1-кооф: .../Еозз11/мерзлее/ 
сопЕ19-Чр: С:/0зегз/РСОзек/Арррафа/Тоса1/ 03511 


срескоче: а8ера7176с098Е320а19а1с63е7585с8ааеь80Ее 2020-03-02 
07:13:30 ОТС 
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рагепе: 24е23с5сЕБЮБа7ре781аба8©6е7аЯ9с8е12е9сас4 2020-02-29 
07:24:50 ОТС 

Тачз: ЕгипК 

сопмепе: Добавлен НТМТ-шаблон 1п4ех.ВЕт1 (изек: Тирозет1) 


Всё выглядит так, как будто файл шаех.И т! попал в репозиторий. Но дей- 
ствительно ли он уже присутствует на сервере? Для получения ответа на этот 
вопрос можно в адресной строке веб-браузера набрать ОВГ, сетевого репозито- 
рия: ИИр:/М№оз$1.зегуег:8081/ и на открывшейся веб-странице выбрать пункт гори- 
зонтального меню Титете (Шкала времени). Отобразится веб-страница, пока- 
занная на рисунке 4.4. 


= О х 
© 5тлреЕ этае-раде мебзИе: Ти. Хх + 


= С О Не защищено | 40$51,5егуег8 081 Аитейпе & х Э 


эитр/!е зэтае-раде меь$Ке / тиене г 


Ейез Вгапспез 


Адуапсед |Модет \Мем *| Мах. 50 Среск-тз т 


2 спеск-т$ 
2020-03-02 
а Добавлен НТМЕ -шаблон тдех НА! 
ГеаЁ спеск-п: а3е597176с изег. |трозег1 1ад3: типк 
2020-02-29 
ие ина! етр\у спеск-шп спеск-п: 24223655 изег Зе!ирИзег1адз: лиг 
Рис. 4.4 


Шкала времени репозитория проекта 


На схеме видны два события, которые произошли с репозиторием с начала 
его существования. Первое событие, которое отображается внизу, — ма! етру 
спеск-т (начальная пустая загрузка) — фиктивная отметка, являющаяся началом 
отсчёта времени жизни проекта. Второе событие соответствует только что вы- 
полненному добавлению файла таех.птт, о чём свидетельствует его описание. 


4.1.6. Выгрузка обновлений из репозитория 


Оставим пока что первого верстальщика трозег1, который уже подгото- 
вил своё рабочее место, и поможем справиться с этой задачей менеджеру про- 
екта Мападег, который как раз вернулся с совещания и готов уделить производ- 
ственной рутине несколько минут. 
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Первым делом надо получить копию сетевого репозитория: 


Ео$$11 с1оре БЕЕр://Мападег@Еоз311.зегуег:8081/ зэзриебз1ее-1оса1.Еоз5$11 


Затем — создать рабочий каталог и развернуть в него репозиторий: 


пка1к мерз1ее 
са мерз1е 
Ео5811 ореп ..\ззриебз1ее-1оса1.Ео$$11 


Если теперь посмотреть содержимое рабочего каталога (с помощью ко- 
манды ай в \УЛпдо\з или команды 1 в Ошх/Апих), то будут отображены два 
файла: _РОЗЗ_ или ЮСсКош (который, как мы помним, содержит служебную 
информацию о рабочем каталоге и привязку к №53 -файлу локального репози- 
тория) и таех.Пт|. 

Произошло маленькое чудо: результат работы одного сотрудника через 
сервер попал к другому. Менеджер проекта вполне удовлетворился таким ре- 
зультатом и занялся составлением графиков. 

Посмотрим, как идут дела у второго верстальщика. Он уже получил ло- 
кальную копию сетевого репозитория, развернул её содержимое в рабочий ка- 
талог и сейчас был занят тем, что приводил текст в файле паех.йт! к стандарту 
НТМЕ5. В результате его усилий содержимое файла таех.Нт! приобрело вид: 


Листинг таех. ит 


<!аосбуре ВЕп1> 
<рем1 1апад="ги"> 
<реаа> 
<&161е>51ир1е з1па1е-раде мерз16е</&1Е1е> 
<пефа спагзеф="аЕЕ-8"> 
</веаа> 
<Боду> 
<В1>Простой одностраничный веб-сайт</61> 
</Боау> 
</ВЕт1> 


Посмотрим, каково состояние проекта с точки зрения Ео$$1, для чего вы- 
полним команду: 


Еоз5$11 срапаез 


Ответ уместился в одной строке: 


вОТТЕР 1паех.6 м1 


Это означает, что система контроля версий обнаружила отличия в файле 
паех.пт, находящемся в рабочем каталоге, по сравнению с состоянием, кото- 
рое хранится в локальном репозитории. Верстальщик |трозег2 готов поделиться 
своим видением НТМГ-шаблона с коллегами, однако перед этим он решил 
сконфигурировать репозиторий таким образом, чтобы не выдавалось предупре- 
ждение о двухсимвольных признаках завершения строки СА/СЕ: 


Еоз$11 зееЕ1па$ сг1Е-а1оЬ '*' 


После этого он выполняет загрузку состояния рабочего каталога в ло- 
кальный репозиторий с помощью команды ю$$1 соттй, при этом в командной 
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строке с помощью опции -т сразу указывает описание внесённых им измене- 
ний: 
05511 соши16 -м "1п4ех.Ю®и1 приведен к стандарту НТМЬ5" 


Но что-то пошло не так, как ожидалось. В терминале вывелась строка: 
Ащозупс: Ир://трозег2@То$$1.зегуег:8081/, и программа задумалась на несколько 
десятков секунд. Потом появились строки: 


саппоЕ соппесЕ во позе Ео5511.зекуег:8081 (невозможно подключиться к 
серверу) 


Ра11 аопе, зепе: 0 геселуеа: 0 1р: 


Апсозупс Ёа11еа. (Автоматическая синхронизация не удалась.) 
и запрос: 


сопЕ1пае 1п зр1е оЕ зупс Еа1ф1аке (у/М)? (продолжить, несмотря на 
ошибку синхронизации?) 


Верстальщик ввёл У для того, чтобы состояние рабочего проекта загрузи- 
лось в локальный репозиторий без синхронизации, а решение проблем В работе 
сети решил отложить на потом. Выполнение команды продолжилось: 

Мем Уегз1оп: 
925Е34850е=82с40430е31183664е=90501е3489150са0484еа6Ъа15а93Е79=83 
Апбозупс: ВЕфр: //Ттрозег2@Ео5$11.зекхуегк:8081 / 

саппоЕ соппесЕе фо ВозЕ Ео$511.5егуег:8081 

Зупс аопе, зепе: 0 геселуеа: 0 1р: 

Аифозупс Еа11еа. 


Последняя строка говорит о том, что автоматическая синхронизация не 
удалась. Посмотрим, в каком состоянии находится проект с помощью команды 
Ю551 аз. Вот что мы видим: 


героз1Еогу: .../ззриерзтее/.. \ззриерз1Ее-1оса1.ЁЕоз$11 
1оса1-кооё: ../ззрмерз1Ее/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ео$511 


срескоце: 920Е34850еЕ82с40430е31183664еЕч0501е348а 2020-03-02 
19:01:19 ОТС 


рагепе: а8ефа7176с098Е320а1 9а1с63е7р85с8ааеЪ80Ее 2020-03-02 
07:13:30 ОТС 


Сачз: ЕгипкК 


соптепе: 1паех.66м1 приведён к стандарту НТМЬ5 (и5ег: Тирозег2) 


В нижней строке записан комментарий к последней выгрузке. Значит, она 
уже попала в локальный репозиторий. 

Через некоторое время работа компьютерной сети была восстановлена, и 
вестальщик Ппрозег2 зашёл на веб-страницу временной шкалы проекта по ад- 
ресу: НИр:/Мо$зИ.зегуег:8081Аите!те. Там последней отметкой по-прежнему зна- 
чилась запись «Добавлен НТМЁ-шаблон таех.птБ> от пользователя Ппрозе!1. 
Значит, в удалённый репозиторий последние изменения пока что не попали. 
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Чтобы синхронизировать репозитории, верстальщик |трозег2 ввёл коман- 
ду: 


Ео$$11 упс 


В трёх строках, которые были выведены на экран в результате выполне- 
ния команды, нет упоминаний о каких-либо проблемах: 


Зупс мтЕН БЕ фр: //Тирозег2@Ео$5$11.зекуег: 8081 / 
Воппа-Ег1рз: 2 АкгЕ1Еасе5 зепе: 2 гесе1уеа: 0 
Зупс Аопе, зепе: 1478 гесезуеа: 979 1р: 192.168.56.101 


А для проверки состояния сетевого репозитория потребовалось лишь об- 
новить окно веб-браузера (рис. 4.5). 


= х 
© тре эпае-раде мебзйе: Тит. ЖХ + ы 
-— С О незащищено | Фю5$Й,5егуег-8081 Аитейте  х о 
тре этае-раде меь$Ке / тише во 
= Ноте Титейте Ее5 Вгапсвез 
Адуапсед |Модет \Мем *| Мах150 Свеск-тз т 
3 спеск-т$ 
2020-03-02 
19:01 ый 
шдех.А{т! приведён к стандарту НТМЕ5 
Е еаГ спеск-п: 425134850е изег трозег? {ад5: 'типк 
07:13 22 = : 
Добавлен НТМЕ-шаблон тпадех.В{п! спеск-т: а8е597176с изег прозег1 {а0$: 1типк 
2020-02-29 
07:24 
ифа! етруу спеск-тп спеск-п: 24е23с5с изег. ЗеирИзег{адз: {лип 


Рис. 4.5 
Шкала времени на сетевом репозитории после внесения изменений в файл таех.в т 

Тем временем первый верстальщик решил проверить, не произошло ли 
каких-нибудь изменений в сетевом репозитории и ввёл команду Ю$$Й зупс. 
В полученных сообщениях не было предупреждений об ошибках: 
Зупс м1ЕВ ВЕфр://Тмрозег1@Ео$$11.зекуег:8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®е5 зепе: 0 гесе1уеа: 0 
Зупс аопе, зепе: 615 гесе1уеа: 488 1р: 192.168.56.101 
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Поэтому он решил посмотреть обновлённое состояние своего проекта с 
помощью команды 105$ аз. Полученный ответ показал отсутствие измене- 
ний, в последней строке по-прежнему значился его комментарий: 


тероз1фогку: ../Гирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео3$11 
1оса1-коо®: .../Ттрозегк1/мерз1*е/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ёо$511 

срескойе: а8ера7176с098Е320а19а1с63е7585с8ааеб80Ее 2020-03-02 
07:13:30 ОТС 

рагепе: 24е23с5сЕБЮБа7Ье781аба8©бе7аЯас8е12е9сас4 2020-02-29 
07:24:50 ОТС 

ср11а: 925Е34850еЕ82с40430е31183664еЕа90501е348а 2020-03-02 
19:01:19 Те 

Сачз: Екипк 


соптепе: Добавлен НТМЬ-шаблон 1паех.В%м1 (изег: Тиро5ет1) 


Удивлённый, что до сих пор ничего не произошло, он позвонил второму 
верстальщику и был крайне озадачен его утверждением, что тот давно поправил 
файл таех.Нт! и что сделанные им исправления отражены в сетевом репозито- 
рии. 

В поисках слабого звена верстальщик |трозег1 посмотрел шкалу времени 
в своём локальном репозитории, запустив локальный веб-интерфейс командой 
0551 и! ..\ззругебзНе-оса!.103$Й и выбрав в нём пункт меню Тите!те. В верхней ча- 
сти шкалы отображалась запись «таех.вт! приведён к стандарту НТМЕ5», сде- 
ланная верстальщиком |трозег2. Это значит, что локальный репозиторий нахо- 
дится в актуальном состоянии относительно сетевого репозитория, синхрониза- 
ция репозиториев действительно прошла успешно. Почему же изменения, вне- 
сённые вторым верстальщиком, не попали в рабочий каталог? 

Побродив по страницам документации проекта Ео$$|, верстальщик 
Пирозег1 понял свою ошибку. Он полагал, что команда 10$$1 зупс, выполненная 
из рабочего каталога, осуществляет как обмен изменениями между локальным и 
сетевым репозиториями, так и отражение нового состояния локального репози- 
тория на рабочий каталог. На самом деле это не так, в чём он только что смог 
убедиться. Эта команда действительно синхронизирует репозитории, но рабо- 
чий каталог при этом не затрагивается. 

Для отображения состояния репозитория, к которому привязан рабочий 
каталог, на файлы рабочего каталога, надо выполнить дополнительную команду. 
Первый верстальщик ввёл её с клавиатуры: 


Ео$$11 прдафе 


В окне терминала отобразился результат выполнения команды: 


Апбозурс: Вер: //Ттрозекг1@Ео$$11.зекуег: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Ро11 аопе, зепе: 394 геселуеа: 484 1р: 192.168.56.101 
ОРРАТЕ 1паех.6&и1 ОБНОВЛЁН 1п4дех.ВЕт1 


ирааееа-Фо: 294380323<45а51еЕ612Е64765439е8 594а5аа04 2020-03-03 08:42:46 ОТС 
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Тачз: ЕгипкК 

соптепе: 1паех.6м1 приведен к стандарту НТМЬ5 (и5ег: Тирозег2) 
срапдез: 1 Е11е шоа1Е1еа. изменения: 1 файл модифицирован. 
"Еоз$11 ипао" 15$ ауа11аб1е Со ипао сВапдез во Бе мокклпа сВесКоц®. 


Из полученных сообщений отчётливо видно, что файл таех.И{т! наконец- 
то обновился. В последней строке содержится подсказка, как откатить получен- 
ные изменения, если после них проект вдруг перестанет работать: надо выпол- 
нить команду 10$$1 ипао. Пока же всё идёт так, как и ожидалось с самого начала. 
Если теперь выполнить команду ю$$й замз, то будет получен ответ: 


тероз1фогу: .../ТГирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео$$11 
1оса1-коо®: .../Ттрозег1/мерз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 035511 

среской®: 294385323с645а51еЕ612Е64765439е854аа5аа04 2020-03-03 08:42:46 ОТС 
рагепе: а8ера7176с098Е320а19а1с63е7685с8ааер80{е 2020-03-02 07:13:30 ТС 
Тачз: Египк 

соптепе: 1паех.66м1 приведен к стандарту НТМЬ5 (и5ег: Тирозег2) 


Если сравнить полученные сведения о состоянии проекта с теми, которые 
получил второй верстальщик, то можно увидеть, что они совпадают начиная с 
параметра «рагепЕ». Наконец-то рабочий каталог у обоих верстальщиков полу- 
чил одинаковое содержимое. 

Сейчас можно отметить ещё одно важное наблюдение. Команда Ю$$1 
Заз выводит информацию об изменениях, которые произошли в рабочем ка- 
талоге с момента последнего информационного обмена с репозиторием. Она не 
производит сравнение текущего состояния рабочего каталога с состоянием ло- 
кального репозитория, как можно было бы подумать. Именно поэтому даже в то 
время, когда локальный репозиторий был уже синхронизирован с сетевым репо- 
зиторием командой 10$$й зупс, команда 105$ защ ничего не сообщала о его но- 
вом состоянии. 


4.2. Конфликт изменений 


4.2.1. Одновременное редактирование файла 


Воодушевившись первым успехом, оба верстальщика принялись за разра- 
ботку веб-страницы. Очевидно, она не сможет обойтись без стилевого оформ- 
ления. 

Первый верстальщик решил разместить стили во внешнем файле, для че- 
го создал файл таех.сз$, содержащий пока что единственную строку: 


* {пага1п: 0; рааа1та: 0} 
А в файл таех.ит! в конец элемента <Веа4> добавил строку: 


<11пК ВкеЕ="1раех.сзз" ге1="зсу1езреее" фуре="еехе/сзз"> 


Пока первый верстальщик проверял результат своей работы, второй вер- 
стальщик в конец элемента <Неа4> добавил стилевой блок: 
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<56у1е> 
* {пага1п: 0; рааа1та: 0} 
</зЕу1е> 
После внесения изменений и сохранения файла таех.Нт! он решил по- 
смотреть, чем отличаются исправленные варианты файлов в рабочем каталоге 
проекта от моментального снимка, хранящегося в репозитории. Для этого вто- 
рой верстальщик ввёл команду: 


Ео$$11 А1ЕЕ 


Команда вывела информацию о различиях в следующем виде: 


Трпаех: 1паех.6 м1 


—--- тлаех.В м1 
+++ 1паех. Вет 
@@ -1,10 +1,13 @@ 
<!Зосбуре ВЕт1> 
<ВЕм1 1апа="ки"> 
<реаа> 
<Е1Е1е>51тр1е з1па1е-раде мебз16е</&1Е1е> 
<пефа свагзее="аеЕ-8"> 
+ <5Еу1е> 
+ * {пага1п: 0; рааа1та: 0} 
+ </зЕу1е> 
</веаа> 
<Боау> 
<р1>Простое одностраничное веб-приложение</в1> 
</Боау> 
</6Ет1> 


В первой строке паех: сообщается, что дальнейшие сведения относятся к 
файлу шаех.пт!. После разделительной черты из знаков равенства = идут две 
строки с именами сравниваемых файлов: символами --- обозначено имя исход- 
ного файла, символами +++ обозначено имя результирующего файла. В данном 
случае сравнивается прошлый файл таех.Нт! с файлом нынешним, поэтому 
имена совпадают. 

Затем идёт заголовок блока различий. Это строка, которая начинается и 
заканчивается символами @@, между которыми находятся две пары чисел, раз- 
делённых запятой. Пара чисел, обозначенная знаком минус, относится к исход- 
ному файлу, а знаком плюс — к результирующему. 

Первое число пары означает номер строки в файле (исходном или резуль- 
тирующем), с которой начинается следующий после заголовка блок различий, а 
второе число — количество строк в файле (исходном или результирующем), за- 
мещаемых этим блоком различий. В рассматриваемом примере блок различий 
должен быть наложен на начало обоих файлов (строка номер 1) и соответствует 
всему их содержимому (10 строк в исходном и 13 строк в результирующем). 
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Далее, с отступом в один символ от левой границы, идёт содержимое бло- 
ка различий, т.е. строки, отражающие результат сравнения. Символ, находя- 
щийся непосредственно у левой границы, означает следующее: 

® пробел — строка присутствует как в исходном файле, так и в результи- 
рующем, в неизменном виде; 

® знак плюс (+) — строка отсутствует в исходном файле, но присутствует 
в результирующем (добавлена); 

® знак минус (-) — строка присутствует в исходном файле, но отсутствует 
в результирующем (удалена). 

В общем случае таких блоков различий может быть несколько — по од- 
ному для каждого различающегося участка сравниваемых файлов. Неизменные 
строки в блоках различий помогают установить контекст, к которому относятся 
содержащиеся в блоке описания различий. 

В приведенном примере, как и ожидалось, знаками + обозначены строки, 
добавленные в заголовок НТМГ-кода веб-страницы. 

Удовлетворённый проделанной работой, второй верстальщик загрузил но- 
вое состояние рабочего каталога в репозиторий проекта командой: 


Ео$з$11 соми1е -м "добавлен стилевой блок" 


Процедура загрузки прошла без ошибок: 


Апбозурс: ВЕфр://Ттрозег2@Ео5$11.зекуег: 8081 / 
Воппа-6г1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 
Рои11 аопе, зепё: 431 геселуеЯ: 488 1р: 192.168.56.101 
Мем_Уегз1оп: 
3858а0865Е8е4642сес82705Е5164а5649ас0са216296с9194еа6ра69е719Е8а 
Апбозурс: ВЕЕр://Тирозег2@Ео5$11.зекхуег: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®5$ зепе: 2 гесе1уеа: 0 
Зупс аопе, зепе: 924 гесе1уеа: 560 1р: 192.168.56.101 


Тем временем первый верстальщик занялся подготовкой загрузки своего 
рабочего каталога в репозиторий. Поскольку он не только вносил изменения в 
существующий файл проекта, но и создал новый файл, то решил посмотреть 
перечень файлов рабочего каталога, которые пока что не включены в контроль 
версий, с помощью команды: 


Еоз$11 ехЕегаз 


Выведенный список, как и ожидал верстальщик, содержал единственный 
файл: 
1раех.с$$ 

Верстальщик включил его в контроль версий с помощью команды: 
Еоз311 ааа 1паех.сз$ 


На экране появилось подтверждение выполненной операции: 
АРОЕР 1паех.с$$ 


Теперь всё готово к загрузке проделанной работы в репозиторий. 


72 


4.2.2. Начало конфликта 


Чтобы загрузить состояние рабочего каталога в репозиторий, верстальщик 
|прозег1 ввёл команду: 


Ео$$11 сопи1е -м "к 1паех.06т1 подключён файл с таблицей стилей 1паех.сз5" 


В ответ он получил неожиданное сообщение 
Апбозурс: Вер: //Ттрозег1@Ео5$11.зекхуег: 8081 / 
Воипа-6г1рз: 2 АкЕ1Еасё5 зепёе: 0 геселуеа: 2 
Ри11 аопе, зепё: 913 гесе1уеа: 1366 1р: 192.168.56.101 
Мои1А ЕокКк. "орааЕе" Е1кзЕ ог азе --БхапсВ ог --а11ом-Еокк. 


Последняя строка сообщает: «Требуется создать ответвление. Выполните 
сначала команду ир4ае или используйте опции --бгапсй или --аНомл-рютк». Что- 
бы посмотреть, в каком состоянии сейчас находится его локальный проект, вер- 
стальщик Пирозег1 выполнил команду: 


Еозз11 збабаз 


Ответ выглядел следующим образом: 


тероз1фоку: .../Пирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео3$11 
1оса1-коо®: .../Ттрозег1/мерз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ро$511 

срескойе: 925Е34850еЕ82с40430е31183664еЁ90501е3 48а 2020-03-02 19:01:19 ТС 
рагепе: а8ера7176с098Е320а19а1с63е7р85с8ааер80Ее 2020-03-02 07:13:30 ПТС 
ср11а: 3858а0865Е8е4642сес82705:514а5644ас0са2 2020-03-04 07:05:06 ОТС 
фачз: ЕгипК 

соптепе: 1паех.66т1 приведён к стандарту НТМЬ5 (и5ег: Тирозег2) 
АРОЕР 1паех.с$$ 

ЕОТТЕОР 1паех.ВЕи1 


Последним по-прежнему значится комментарий верстальщика |трозег2 о 
приведении файла таех.Нт! к стандарту НТМГ5, файл тдех.с$$ отмечен как 
представленный к включению в контроль версий, а файл таех.Нт! значится мо- 
дифицированным. Из всего этого следует, что попытка выгрузки завершилась 
неудачно, состояние репозитория не изменилось. 

Чтобы разобраться с причинами неудачи, верстальщик |трозег1 посмот- 
рел шкалу проекта в веб-браузере по ссылке Ийр:/№$$1.зегуег:8081Аите!те и об- 
наружил свежую запись с комментарием «добавлен стилевой блок», сделанную 
вторым верстальщиком. Для того, чтобы увидеть детали скрывающихся за этой 
записью изменений, он перешёл по гиперссылке с идентификатором записи 
3868а08651 (на самом деле в веб-интерфейсе отображаются лишь первые десять 
шестнадцатеричных цифр идентификатора) (рис. 4.6). 

Веб-страница, которая отобразилась после перехода по гиперссылке, со- 
стоит из трёх частей (рис. 4.7). В верхней части, озаглавленной Оуегмем (Об- 
зор), содержится общая информация об изменении: комментарий, полный иден- 
тификатор, имя пользователя-инициатора, дата и время внесения изменения. 
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В средней части, озаглавленной Сощех{ (Контекст), отображается элемент вре- 
менной шкалы, содержащий выделенную цветом запись о текущем изменении, 
а также запись, непосредственно предшествующую просматриваемому измене- 
нию. 


-_ О х 
е эитре зиа!е-раде \меБзИе: Тит Ж + 
< С О Не защищено | %0$5$1.5егуег:8081 Аитейте х ©@ 
тре этае-раде мер Ке / теже ум 
= Ноте Титейпе Е!е5 ВгапсВез 
Адуапсед |Модет \Мем | Мах150 Свеск-тз у 
4 спеск-т$ 
2020-03-04 
07:05 ы Е 
добавлен стилевой блок Геа{ спеск-т:|3 ег. итрозег2 {ад$: 1гипк 
2020-03-02 
19:01 р в 
пдех.пт! приведён к стандарту НТМЕ5 спеск-и: 92134850е изег: ипрозег2 1адз: ‘ип 
07:13 м — - 
Добавлен НТМ!-шаблон тдех.Вт! спеск-п: а8е697176с изег: трозе!1 {адз: {гипк 
2020-02-29 
07:24 ре ь 
миа! етр\у спеск-тп спеск-т: 24е23с5с® изег. ЗеирИзег{ад$: {гипк 
Рис. 4.6 


Для просмотра деталей изменений, скрывающихся за записью на шкале времени, 
можно перейти по гиперссылке с идентификатором записи 


Детальные сведения об изменении содержатся в нижней части, которая 
озаглавлена СВапдез. Сверху у неё имеется своё горизонтальное меню, с помо- 
щью которого можно менять способ отображения деталей изменения. По умол- 
чанию область отображения разделена вертикальной границей на две части. 
В левой части показано состояние файла до изменения, а в правой части — по- 
сле. При этом изменённые строки выделены цветом. 

Если на экране такой вариант отображения выглядит слишком мелким, то 
можно переключить режим отображения на вариант ЦпМед Оз (Унифи- 
цированный формат) с помощью одноимённого пункта меню. После этого про- 
смотр деталей изменения становится более комфортным (рис. 4.8). 


74 


® тре эпае-раде мебзйе: ве хо + 


< -> С О незащищено | 10551.5егуег8081//п1ю/3868а086518е4642 х @: 


тре этае-раде ме $Ёе / снескп (заьва0865П подо 


7% 


= Ноте Титейпе Ре$ Вгапсвез 


: добавлен стилевой блок 
: Тагфа! | Р агсв\е | ЗО агсыме 
Пте!пез: Гатйу | апсез{ог$ | @гипк 
РИез: Нез | Ме адез | одегз 
$НАЗ-256: @ 3868а086518е4642сес827051515495644ас0са2162965с9194е465969е7 19184 
Узег & Оа!е: |трозег2 оп 2020-03-04 07:05:06 
Очнег МпКз: тапйе<! | {29$ 


Сомех{ 


2020-03-04 


спеск-п: 925134350е изег трозег2 {ад$: гипк 


Нае 0$ | Упйед 0$ | 1юпоге \МПцезрасе Расв 


Модтечд 'пдех. пт! гот [185097329е] \о [923161с2сч]. 


1 <!боскуре Выяа> 1 <!оскуре Ве 
2 вы 1апв="гы"> 2 сны 1аав=“ги*> 
<«пеаё> <Веад> 
<ЕЕЛебЬирае э1ав1е-рае меБьаЛе<и Ее» «Ее Аюрье э1иа1е-раве мебзлесикаие> 
<тета спагзей-“+-8"> <тефа спагзеа”щ+-8"> 


</Пеав> </пеза> 
<6оду> 12 
<81>Простое одностраничное веб-приложение‹/№1> 11 <В1>Простое одностраничное веб-приложение‹/№1> 
</воау> 12  </водух 
</ > 13 хмаь 


Рис. 4.7 
Веб-страница с информацией об изменении 
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© тре зтае-раде меБзе: Се Хх + 


— С О Не защищено | 10551,5егуег-8 081 /ипю/3853а08653е4642?а НН =1 ж © 


Спапдез 


Нае Оз Э5е-бу-54е Оз 19дпоге \\Пйезрасе Раксп 


Моа\ед пдех. пт! тот [1850973292] №ю [923161с2с9] 


<!досфуре В4т1> 
<ВЕт1 1апё="”ги"> 
<Веаа> 
<+141е>51тр1е 51п21е-раре меб 514е</+141е> 
<тефа сКагзеф="и{+-8"> 
+ <54у1е> 
+ * {тагё1т: 9; рада1тЕ: ©} 
+ </51у1е> 
</Веаа> 
<Боду> 
<Р1>Простое одностраничное веб-приложение</В1> 
</Боду> 
</ВЕт1> 


Рис. 4.8 
Просмотр изменений в режиме Иифеа Ри5 (Унифицированный формат) 


Для просмотра различий между моментальным снимком рабочего катало- 
га, загруженного верстальщиком |трозег2 в репозиторий под идентификатором 
3868а0865+, и своим рабочим каталогом верстальщик |трозег1 ввёл команду: 


Ео$$11 А1ЕЕ -г 3868а0865Е 


Команда вывела подробную информацию о различиях: 


АРОЕР 1раех .с$5 
Траех: 1паех.В м1 


—--- 1лпаех.6ем1 

+++ 1паех.6ем1 

@@ -1,13 +1,11 @@ 

<!ЧЗосбуре ВЕт1> 

<ВЕм1 1апч="киа"> 
<реа@а> 


<Е1Е1е>51тр1е з1па91е-раде мебз16е</&1Е1е> 
<пефа свагзее="аеЕ-8"> 
- <56у1е> 
ых * {пага1п: 0; рааа1та: 0} 
- </зЕу1е> 
+ <11пКк ВгеЕ="1рпаех.сзз" ге1="зсу1езцеее" фуре="Еехе/сзз"> 
</веаа> 
<Боду> 
<р1>Простое одностраничное веб-приложение</в1> 
</Боау> 
</вЕт1> 
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Теперь стало очевидно, что система контроля версий оказалась в затруд- 
нительном положении, поскольку оба верстальщика предложили два разных 
направления развития проекта. И, поскольку второй верстальщик успел выгру- 
зить свои изменения раньше, искать выход из сложившейся ситуации придётся 
первому верстальщику. 


4.2.3. Обострение конфликта 

Следуя рекомендации Ео$$1, верстальщик |трозег1 выполнил команду на 
получение изменений из репозитория в свой рабочий каталог: 
Ео$$11 праафе 

Команда завершилась успешно с выдачей нескольких информационных 
строк: 


Апбозурс: ВЕфр://Ттрозег1@Ео5$$11.зекхуег: 8081 / 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепе: 397 геселуеа: 560 1р: 192.168.56.101 

МЕВСЕ 1паех.6ВЕп1 СЛИЯНИЕ 1паех.6 м1 

ххжхх 1 пегае сопЕ11сЕ$ 1п 1п4ех.В6т1 1 конфликт слияния в 1таех.6и1 


ирааееа-Фо: 3858а0865Е8е4642сес82705Е515495644ас0са2 2020-03-04 07:05:06 ОТС 
Тачз: ЕгипК 

соптепе: добавлен стилевой блок (и5ег: Тирозег2) 

свапаез: 2 Е11ез шоа1Е1еа. 

МАВМТМС: 1 шегае сопЕ11се5$ ВНИМАНИЕ: 1 конфликт слияния 

"Ео$$11 ипао" 1$ ауа11аб1е во ипао сВапаез во ЕБе могК1па срескойе. 


Верстальцику |трозег1 стало чрезвычайно любопытно, как поступил 
Ео5$1 с противоречиями в файле таех.в!т|, и его руки потянулись к текстовому 
редактору. Но он сдержал этот порыв и решил разобраться с ситуацией после- 
довательно, для чего сначала посмотрел состояние рабочего каталога командой: 


Еозз11 збабаз 


Команда вывела такое сообщение: 


тероз1фогку: .../Пирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео$$11 
1оса1-кооф: .../Ттрозек1/мерз1ке/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ро0$511 


срескоце: 38Ю8а0865Е8е4642сес82705Е51549564аас0са? 2020-03-04 
07:05:06 ОТС 


ракепф: а25Е34850еЕ82с40430е31183664еЕа0501ез3 48а 2020-03-02 
].9*.0151.9 ЭТе 


Сачз: Екопк 


соптепе: добавлен стилевой блок (изег: Тирозег2) 
АРРЕР 1паех.сз5 ДОБАВЛЕН 1п4аех.с5$$ 
СОМЕТТСТ 1паех.6т1 КОНФЛИКТ 1паех.ВЕм1 


Если текущее состояние сравнить с состоянием, в котором находился ра- 
бочий каталог непосредственно перед выполнением команды 10$$Й ирдае, то 
можно заметить два отличия. Во-первых, произошло переключение точки от- 
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счёта изменений от состояния «шаех.Вит] приведён к стандарту НТМТ. (изег: 
Ппрозег2)» к состоянию «добавлен стилевой блок (изег: Ппрозег2)». То есть пер- 
вый верстальщик уступил второму и принял его изменения в свой локальный 
репозиторий. 

Во-вторых, последние изменения, выполненные первым верстальщиком, 
пересчитались для нового состояния репозитория. Второй верстальщик не со- 
здавал файла с именем тдех.с$$, поэтому его отметка «добавлен» осталась 
прежней. А файл таех.в!т|, в который первый верстальщик вставил строку для 
привязки к нему файла с таблицами стилей пдех.с$$ и в который в это же время 
второй верстальщик добавил стилевой блок, вместо отметки «отредактирован» 
получил отметку «конфликт». 

Наконец верстальщик |трозег открыл в текстовом редакторе файл 
пдех.1тт, чтобы посмотреть суть конфликта. И вот что он увидел: 


<!аосбуре ВЕп1> 
<рем1 1апа="ги"> 
<реаа> 
<&161е>51ир1е з1па1е-раде мерз16е</&1Е1е> 
<мефа свагзее="аеЕ-8"> 
<<<<<<<< ВЕСТМ МЕВСЕ СОМЕШТСТ: 1оса1 сору зВомп Е1к5е <<<<<<<<< 
<11пк ркеЕ="1раех.сзз" ге1="з6у1езрееф" фуре="вехЕ/сзз"> 
</веаа> 
======= СОММОМ АМСЕЗТОВ сопеепЕ Ео11о0ом5 
</Беаа> 
======= МЕВСЕР ТМ сопфепЕ Ео11о0м5 
<56у1е> 
* {пагда1п: 0; рааа1та: 0} 
</зЕу1е> 
</веаа> 
>>>>>>> ЕМО МЕВСЕ СОМЕШТСТ >>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
<Боду> 
<В1>Простое одностраничное веб-приложение</в1> 
</Боау> 
</ВЕт1> 


Система Е0$5 попыталась в меру своих способностей объединить два ва- 
рианта файла таех.Нт!— со стилевым блоком, вставленным верстальциком 
|трозег2, и с привязкой файла с таблицами стилей, реализованной верстальщи- 
ком !трозег1 — в один файл. Строка ВЕСИМ МЕРСЕ СОМЕЧЦСТ: |оса! сору зНомт 
#гз+ (НАЧАЛО КОНФЛИКТА СЛИЯНИЯ: сначала показана локальная копия) 
отмечает начало комбинированного блока, а строка ЕМО МЕВСЕ СОМЕНСТ 
(КОНЕЦ КОНФЛИКТА СЛИЯНИЯ) — его конец. Строкой СОММОМ АМСЕЗТОВ 
сотепт Ю!о\мз отмечена общая часть конфликтующих участков текста, а после 
строки МЕВСЕС !М сощег{ 1юНомз следует блок текста, полученный из сетевого 
репозитория. 

Помимо этого, если сейчас посмотреть содержимое рабочего каталога, в 
нём можно обнаружить три новых файла — различные варианты таех.Ит!: 
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® паех.П{т!-базейте — вариант файла шаех.пт! непосредственно перед 
внесением в него конфликтующих изменений (как первым, так и вторым вер- 
стальщиком); 

® паех.пит|-опдта! — вариант файла паех.п!т! верстальщика |трозег1 до 
того, как система Ео5$ произвела его модификацию из-за возникшего конфлик- 
та (своеобразная резервная копия); 

® паех.П{т|-тегде — вариант файла пдех.Нт|, полученный из репозитория 
(с изменениями, выполненными верстальщиком 1трозег2). 

Очевидно, что структура файла таех.п!т|, находящегося в рабочем ката- 
логе верстальщика |трозе!1, сейчас нарушена. Верстальщику необходимо взять 
текстовый редактор и принять непростое решение относительно того, чей вари- 
ант развития проекта оставить. Вероятно, он созвонится со вторым верстальщи- 
ком, они обсудят преимущества и недостатки обоих вариантов и примут согла- 
сованное решение. 


4.2.4. Уступает второй верстальщик 


Предположим, что верстальщик |трозег2 согласился с тем, что лучше 
максимально отделить оформление веб-сайта от его содержания и вынести его в 
отдельный файл таех.с$$, как это сделал верстальщик !трозег1. Тогда итрозег1 
должен привести файл шдех.Ит! к тому виду, который был до того, как система 
Роз выразила в нём своё видение ситуации, и снова выполнить команду: 


Ео$$11 сопи1е -шм "к 1паех.БЕт1 подключён файл с таблицей стилей 1паех.сз$" 


Так и поступил первый верстальщик. Он открыл редактор, убрал создан- 
ный вторым верстальщиком стилевой блок и внесённые системой Роз мар- 
керные строки, при этом оставил свою ссылку на таех.сзз, переключился на ок- 
но командной строки и выполнил приведенную команду. Однако в ответ полу- 
чил сообщение об ошибке: 


Апбозурс: Вер: //Ттрозег1@Ео$$11.зегхуегк:8081 / 

Воппа-Ег1рз: 1 Аге1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепе: 430 геселуеа: 560 1р: 192.168.56.101 

роз$161е ипгезо1уеа мегде сопЕЁ11сЕ 1п ./1паех.Вт1 

абогЕ аЧае Ео ипгезо1уеа мегае сопЕ11се$; и5е --а11ом-сопЕ11сЕ во оуегглае 


В последних двух строках говорится следующее: 
возможно неразрешённый конфликт слияния в „./1паех.БЕт1 прервано по 
причине неразрешённых конфликтов; используйте --а11о0ом-сопЕЁ11се фо 
оуегг1ае 

Оказывается, верстальщик Нтрозег1 забыл сохранить изменения из тек- 
стового редактора в файл таех.пт!. Быстро исправив свою оплошность, он ре- 
шил взглянуть на состояние рабочего каталога с помощью команды Ю5з$1 Зав. 
Теперь предупреждение СОМЕИСТ (КОНФЛИКТ) у файла таех.сз$ преврати- 
лось в обычную рабочую отметку ЕГИТЕО (ОТРЕДАКТИРОВАН): 


тероз1фогу: ../Пирозек1/меБзлее/. .\ззриерз1Ее-1оса1.ЁЕо3$11 
1оса1-коо®: .../Ттрозег1/мерз1ее/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 
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срескойе: 3858а0865Е8е4642сес82705Е515495649ас0са2? 2020-03-04 07:05:06 ЧТС 
рагепе: а25Е34850еЕ82с40430е31183664еЕ90501е3 48а 2020-03-02 19:01:19 ОТС 
Кач: ЕкипкК 
соптепе: добавлен стилевой блок (и5ег: Тирозег2) 
АБОЕР 1паех.с$$ 
ЕОТТЕО 1паех.Ви1 

Повторив приведенную выше команду 10$$1 сотии..., первый верстальщик 
наконец-то загрузил результат своего труда в репозиторий: 


Апбозупс: Вер: //Ттрозег1@Ео$$11.зекхуег: 8081 / 

Воппа-6г1рз: 1 АкгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Ра11 аопе, зепе: 431 гесезуеа: 560 1р: 192.168.56.101 

Мем Уегз1оп: 
0е9967045е7с47е9203е9с0836347с61ас4е5с20с8а506саЗа3046269сс8033а 
Апбозупс: Вер: //Ттрозег1@Ео5$$11.зекуег: 8081 / 

Воппа-6г1рз: 1 АгЕ1Еас®5 зепе: 3 гесе1уеа: 0 

Зупс аопе, зепе: 1107 гесезуеа: 670 1р: 192.168.56.101 


Конечно же, верстальщик |трозе!1 не смог устоять перед искушением по- 
смотреть состояние сетевого репозитория. Вот что он увидел, перейдя по ссыл- 
ке Ир:/№оз$1.зегуег:8081Айте!те на шкалу времени проекта (рис. 4.9). 


= О х 
© этрЕ эпае-раде меб5йе: Тит. Хх + 
< -> СО незащищено | Фю$$1.5егуег:8081 Аитейпе * о 
Зипр!е зэтае-раде меь$Ке / теже Ро 
= Ноте Тите!те Рез Вгапспез 
Адуапсед |Модет \Мем у | Мах150 Спеск-тз у 
5 спеск-и5 
2020-03-04 
17:26 ы а ны 
к таех.Пигп! подключён файл с таблицей стилей таех.с$$ 
Геа{ спеск-п: 0е9967045е изег: !трозе!1 {ад5: {гипк 
07:05 ы 
добавлен стилевой блок спеск-т: 3858а08651 изег: !трозег2 1адз: 1гипк 
2020-03-02 
19:01 : 
ипдех.И!т! приведён к стандарту НТМЕ5 спеск-т: 426134850е изег: трозег2 {адз: ‘гипк 
07:13 = 
Добавлен НТМЕ-шаблон тдех.Рт! снеск-п: а3е597176с изег: трозег1 {ад$: гипк 
2020-02-29 
07:24 - ь 
ша! етр!у спеск-п спеск-т: 24е23с5с®о изег: ЗешрИзег{ад$: {типк 


Рис. 4.9 
Шкала времени проекта: победил вариант первого верстальщика 
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А детальные изменения в режиме Уп\еа 0$ выглядят, как показано на 
рисунке 4.10. На нём видно, что в качестве исходного варианта для модифика- 
ции файла паех.Нт! был взят предложенный верстальщиком !трозег2 текст, со- 
держащий стилевой блок в строках 6-8. Последними изменениями, которые 
предоставил верстальщик |трозе!1, эти три строки удалены (они отмечены зна- 
ками «минус» и выделены красным цветом), и их место заняла строка, содер- 
жащая ссылку на файл таех.с$$ (она отмечена знаком «плюс» и зелёным цве- 
том). 


@® тре этае-раде мебзИе: СКЕ Х + 


= С СФ Незащищено | #05$.зегуег8081/уто/0е9967045е7са7еа?4... 5 © : 
Сотмех! 


2020-03-04 


И й А 
ыы к пдех. Рип! подключён файл с таблицей стилей тдех.с$$ 


Е еаГ спеск-т: 0е9967045е изег. тпрозег1 {адз: гипк 


07:05 к 
добавлен стилевой блок спеск-п: 3858208657 изег трозег? 1адз: нипк 


Спапдез 


Нае О5 $де-Бу-$4е ОШ 1дпоге \\кезрасе Рав 


Адаед таех.сз$ уегэоп [с562е81с41]. 


+* {тагёзт: 0; рада1тв: ©} 


Мод\ед 'пдех.Вит! тот [923161с2с9] №0 [5себ010с5а] 


<!досфуре Вт1> 
<Вт1 1ап8="ги"> 
<Веаа> 
<4141е>51тр]е 51п51е-рабе меб з14е</4+141е> 
<тефа сКагзе{="и+-8"> 
- <5+у1е> 
- * {тагё1т: @; рада1тв: 9} 
- </-+у1е> 
- <13пК ВгеР="1пдех.с5$5" ге1="з+у1езНеее" +уре="+ех+/с$5"> 
</пеад> 
<Боау> 
<В1>Простое одностраничное веб-приложение</в1> 
</Боау> 
</Вт1> 


Рис. 4.10 
Детальные изменения при победе варианта первого верстальщика 
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4.2.5. Уступает первый верстальщик 


Вернёмся к моменту обсуждения наилучшего варианта подключения сти- 
лей к веб-сайту. Предположим, что версталыцики пришли к выводу, что по- 
скольку сайт является одностраничным, то лучше и стили поместить в Вит]|- 
файл — тогда они гарантированно будут загружены вместе с основным содер- 
жимым. Таким образом, прозег1 пожертвовал проделанной работой в пользу 
решения, предложенного трозег2. Но как отобразить это решение на состояние 
репозитория? 

Первый версталыцик может исключить файл таех.с$$ из системы кон- 
троля версий с помощью команды: 


Ео$$11 хм 1паех.с$$ 


Если команда выполнится удачно, на экран будет выведено: 


РЕТЕТЕО 1паех.сз$ (УДАЛЁН 1п4ех.с55) 


В этом сообщении слово «УДАЛЁН» означает удаление лишь из системы 
контроля версий (исключение из списка файлов, подконтрольных системе 
Ео5$1), поэтому удаление его из файловой системы нужно произвести отдельно, 
средствами операционной системы компьютера. В качестве окончательного ва- 
рианта файла тадех.п!т! можно взять файл таех.Нт!-тегде, который был создан 
системой контроля версий и содержит текст, предоставленный вторым вер- 
стальщиком. 

После выполнения описанных действий команда ю$$1 Заз покажет от- 
сутствие изменений в рабочем каталоге по отношению к последнему состоянию 
проекта — варианту, предложенному вторым верстальщиком: 


тероз1фоку: ../Гирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео$$11 
1оса1-коо®: .../Ттрозег1/мерз1ее/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 
срескойе: 3868а0865Е8е4642сес82705Е5154956449ас0са2? 2020-03-04 07:05:06 ЧТС 
рахгепе: а25Е34850еЕ82с40430е31183664еЕ90501е3 48а 2020-03-02 19:01:19 ОТС 
Тачз: ЕгипК 
соптепе: добавлен стилевой блок (изег: Тирозег2) 

Теперь можно попытаться загрузить состояние рабочего каталога в репо- 
зиторий: 
Ео$$11 соши1Е -м "победил вариант, предложенный Тпрозек?2" 


Как можно было ожидать, ничего не произошло: 


Апбозурс: ВЕЕр://Ттрозег1@Ео5$11.зекхуег: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепё: 435 геселуеа: 560 1р: 192.168.56.101 
поЕ11п9 Баз срапдея; изе --а11ом-ешрЕу Фо оуегг1ае 


Сообщение в последней строке говорит: «ничего не изменилось; исполь- 
зуйте --аПо\-етрйу для переопределения». 

В принципе, такой план действий для решения конфликта уместен. Но 
более рациональным с точки зрения верстальщика |трозег1 может быть реше- 
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ние о переводе своего рабочего каталога к последнему состоянию, зафиксиро- 
ванному в сетевом репозитории. А это как раз и будет последняя загрузка, про- 
изведенная в репозиторий верстальщиком |трозег2. 

Выполнить описанную процедуру можно одной командой: 


Еозз11 сБескойЕ --1ТафезЕ --Еогсе 


Она выведет на экран имена файлов в локальном проекте, которые будут 
затронуты процедурой отката. В рассматриваемом примере это единственный 
файл: 
1паех.6 м1 


В приведенной команде ключ --[1е51 требует взять за основу выгрузки в 
рабочий каталог последнее состояние, имеющееся в репозитории, а ключ --/югсе 
вынуждает программу игнорировать тот факт, что в рабочем каталоге есть из- 
менения, которые не были загружены в репозиторий, а значит, будут утеряны в 
результате выполнения команды. Если его не указать, то команда выполнена не 
будет, а будет выведено сообщение: 


фРеге аге ипзауея сВапдез 1п Бе саггепе свескКоче 


4.2.6. Восстановление состояния 


Заметим, что команда $51 сВескош позволяет вернуть содержимое рабо- 
чего каталога не только к последнему состоянию репозитория, но и к любой 
другой точке сохранения, которая была создана в репозитории любым участни- 
ком проекта при загрузке моментального снимка своего рабочего каталога. 
Узнать идентификатор необходимой точки сохранения можно не только через 
веб-интерфейс на странице шкалы времени, но и с помощью команды: 


Ео$$11 Е1те11те 


Для рассматриваемого примера эта команда выведет строки: 


=== 2020-03-04 === 

07:05:06 [3868а0865Е] *СОВВЕМТ* добавлен стилевой блок (и5ег: Тпрозег2 
Тачз: ЕгапКкК) 

=== 2020-03-02 === 

19:01:19 [4925Е34850е] 1паех.ВЕм1 приведён к стандарту НТМЬ5 (иазег: 
Тпрозег2 Еадз: Екипк) 
07:13:30 [а8ефа7176с] Добавлен НТМ-шаблон 1паех.Рет1 (изег: ТГирозек1 
Тачз: Егапк) 

=== 2020-02-29 === 
07:24:50 [24е23с5сЕЪ] 111Е1а1 ешрЕу среск-1п (пзег: бебарОзег $ааз: 
фгипк) 
+++ по шоге Чаба (4) +++ 


В квадратных скобках приведены идентификаторы точек сохранения, за 
ними следуют их описания, а в конце в круглых скобках указаны имена пользо- 
вателей Ео55 — инициаторов соответствующих загрузок. Отметка *СУВВЕМТ* 
находится перед описанием точки сохранения, от моментального снимка кото- 
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рой ведут отсчёт изменения в файлах рабочего каталога, из которого была вы- 
полнена команда. 

Чтобы вернуть рабочий каталог проекта в одно из хранящихся в репози- 
тории состояний, надо ввести команду Ю$$1 снескош с указанием идентифика- 
тора желаемого состояния (точки сохранения), например: 


Еозз11 сБескойе а25Е34850е 


После этого отметка *СУРРЕМТ* переместится на запись, ставшую теку- 
щей: 
=== 2020-03-04 === 
07:05:06 [3858а0865Е] добавлен стилевой блок (изег: Тпрозег2 фадз: 
ЕкопК) 
=== 2020-03-02 === 
19:01:19 [92ЪЕ34850е] *СОВВЕМТ* 1паех.ВЕм1 приведён к стандарту 
НТМЬ5 (изек: Тирозег2 фадз: Екапк) 
07:13:30 [а8ефа7176с] Добавлен НТМ-шаблон 1паех.Рем1 (и5ег: Тирозек1 
Сачз: ЕгопкК) 
=== 2020-02-29 === 
07:24:50 [24е23с5сЕЪ] 1101%1а1 ешрЕу спеск-1п (азег: бебарОзек 
Сачз: ЕгопкК) 
+++ по шоге Чаба (4) +++ 


Подтверждение факта восстановления состояния рабочего каталога мож- 
но получить с помощью команды Ю$$1 Зафиз: 


тероз1фоку: .../Тирозек1/меБз1ее/..\ззриерз1Ее-1оса1.Ео$$11 
1оса1-коо®: .../Ттрозег1/мерз1*е/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ёо$511 

срескойе: а92ЪЕ34850еЕ82с40430е31183664еЁ90501е3 48а 2020-03-02 19:01:19 ОТС 
рагепе: а8ера7176с098Е320а19а1с63е7585с8ааер80Ее 2020-03-02 07:13:30 ЧТС 
ср11а: 3868а0865Е8е4642сес82705Е516495649ас0са2 2020-03-04 07:05:06 ПТС 
Тачз: ЕгипК 


соптепе: 1паех.66т1 приведён к стандарту НТМЬ5 (из5ег: Тирозег2) 


Сейчас должны стать понятными значения полей спескош, рагеп и сНйа, 
которые выводятся в отдельных строках блока информации о состоянии рабоче- 
го каталога проекта: снескощ — это идентификатор текущей точки сохранения, 
от которой ведут отсчёт изменения в рабочем каталоге, рагеп{ — это идентифи- 
катор родительской точки сохранения, которая непосредственно предшествует 
текущей, а сНИа — это идентификатор дочерней точки сохранения, которая 
непосредственно следует после текущей. 

Почему же фактические значения идентификаторов, отображаемых ко- 
мандой !ю0$$1 з{а1из, содержат гораздо больше шестнадцатеричных цифр, нежели 
значения, отображаемые в квадратных скобках командой итеште? Дело в том, 
что значения идентификаторов точек сохранения определяются результатом вы- 
числения хеш-функций на сохраняемых состояниях. Это многозначные числа, 
но их характерная особенность заключается в том, что они сильно меняются во 
всех своих разрядах даже при незначительных изменениях состояний. 
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В большинстве случаев, возникающих на практике, различия присутствуют уже 
в первых десяти шестнадцатеричных разрядах. Поэтому ими ограничен вывод 
идентификаторов состояний в команде юзз1 Чтетпе и в веб-интерфейсе на шка- 
ле времени. 

На практике, когда требуется указать идентификатор состояния, можно не 
вводить даже все десять цифр его сокращённого значения. Достаточно указать 
первые разряды, позволяющие однозначно определить состояние. Например, 
для перехода из текущего состояния «таех.т! приведён к стандарту НТМЕ.5» к 
предшествующему состоянию «Добавлен НТМГ-шаблон таех.и» можно вве- 
сти команду: 


Еозз11 сБескойЕ а8еЪ 


При необходимости указываемое значение идентификатора СОСТОЯНИЯ 
можно расширять и сверх десяти цифр —Щ_ вплоть До его полной ДЛИНЫ. 


4.2.7. Конфронтация 


А теперь предположим, что верстальщикам трозе!1 и |трозег2 не удалось 
договориться — каждый из них настаивает на своём варианте. Более того, вер- 
стальщик трозег1 не последовал рекомендации системы Е05$Й получить из ре- 
позитория вариант |трозег2 и попытаться совместить исходные тексты (т. е. вы- 
полнить команду $$! ираае). Вместо этого он принудительно загрузил свои 
изменения в репозиторий командой: 


Ео$$11 сопм1е --а11ом-Еогк -м "к 1паех.66т1 подключён файл с таблицей 
стилей 1паех.сз$3$" 


Команда завершилась успешно с выводом сообщений: 


Апбозурс: Вер: //Т1трозег1@Ео$$11.зекхуегк:8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепе: 397 геселуеа: 560 1р: 192.168.56.101 
Мем _Уег51оп: 
8Ч4а7а1351560с5Ь649241966525'75Ъ57137105810082ас3с1Ъ275726е5ба4е5ЕЪ8 
Апбозурс: Вер: //Ттрозег1@Ро$$11.зегуег:8081 / 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепЕ: 3 гесе1уеа: 0 

бупс аопе, зепЕе: 1119 гесе1уеа: 671 1р: 192.168.56.101 

*жжххх ПАРМТМС: а Еог’К Ваз оссаггеа ***** 


изе "ЁЕо$$11 1еауез -та1Е1р1е" Еог шоке Чефа11$. 


**** иагп1па: а ЕогКк Ваз оссиггеа ***** 


Почему одно только использование опции --аЙом’-ютк позволило выпол- 
нить команду, ранее вызвавшую такое затруднение у системы контроля версий и 
потребовавшую серьёзного ручного вмешательства специалистов? Почему 
нельзя было поступить так же без дополнительных опций? И что означает два- 
жды приведенная в сообщении команды строка «***** \МААМИМО: а ЮЖ паз 
оссигеа *****» (ВНИМАНИЕ: произошло ответвление)? 

Сначала посмотрим, в каком состоянии оказался рабочий каталог проекта 
с помощью команды 10$$1 аи: 
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тероз1фоку: .../Тирозек1/меБзлее/. .\ззриерз1Ее-1оса1.ЁЕо$$11 
Тоса1-коо®: .../Ттрозек1/мебз1ее/ 

сопЕ19-Ч: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ёо0$511 

свесКкойе: 84а7а1351560с5р6а24195652575571371058100 2020-03-05 14:44:47 ОТС 
рагепе: 926Е34850е{Е82с40430е31183664е{90501е348а 2020-03-02 19:01:19 9ТС 
Тачз: ЕгипК 

соптепе: к 1паех.6Ет1 подключён файл с таблицей стилей 1паех.сз5 
(изег: Ттро5ег1) 

МАВМТМС: ша161р1е ореп 1еаЕ сВеск-1п$ оп Екипк: 

(1) 2020-03-05 14:44:47 [8аа7а13515] (сиггепЕ) 

(2) 2020-03-04 07:05:06 [38Ъ8а0865Е] 


Судя по тексту комментария, содержащемуся в поле соттептЕ, загрузка 
моментального снимка рабочего каталога в репозиторий состоялась. Вызывают 
вопрос последние три строки информационного блока. Сначала идёт предупре- 
ждение: несколько открытых загрузок в итипкК. За ним приведены отметки вре- 
мени двух загрузок с их идентификаторами в квадратных скобках. Первая из 
них отмечена маркером сиитет: (текущая). 

Пояснить, что именно произошло в результате выполнения последней ко- 
манды и в каком состоянии оказался репозиторий лучше всего на схеме времен- 
ной шкалы проекта, доступной по гиперссылке П{р:/Моз$Й.зегуег:8081Айте!те 
(рис. 4.11). 


© тре эпде-раде меБзИе: Ти" Х + р о 
< СО не защищено | 10551.5егмег:8 081 Айтейте * © 
Зипр!е этае-раде ме$Ке / теме со 
= Ноте Тите!те РИез Вгапсвез 
Адуапсед |Модет \Лем *| Мах150 Свеск-пз * 
5 сНеск-тз 
2020-03-05 
14:44 = 
к 'пдех. Вл! подключён файл с таблицей стилей пдех.с$$ т еаГспеск-п: 34а7а13515 изег трозег1 {ад5: гийк 
2020-03-04 
07:05 Вр 
добавлен стилевой блок Ева! снескал: 388208651 изег. |трозег2 Чад: тип 
2020-03-02 
19:01 
ВЕ паех.В!т! приведён к стандарту НТМЕ5 спеск-п: 42348506 изег |трозег2 4адз: ипк 
07:13 = = 
уг Добавлен НТМ!-шаблон тдех.рт! спеск-п: а8е547176с изег /трозег 195: лип 
2020-02-29 
07:24 
пита! етр!у спеск-п спеск-п: 24е23с5с1 изег ЗеирИзаг1адз: {пипк 
Рис. 4.1 


Развилка в работе над проектом 
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На приведенном рисунке видно, что точка сохранения верстальщика 
Нтрозег2 с комментарием «добавлен стилевой блок» присутствует в репозито- 
рии, но она не получила дальнейшего развития. В то же время из точки сохра- 
нения, которая ей предшествует, выросла вторая ветвь, ведущая в только что со- 
зданную верстальщиком Нтрозег1 точку сохранения с комментарием «к 
шаех.В а подключён файл с таблицей стилей шдех.с$5». То есть на данный мо- 
мент в репозитории находятся два конкурирующих варианта развития проекта. 

Так выглядит развилка в сетевом репозитории. С помощью команды Ю5$1 
итеПпе можно взглянуть на неё из рабочего каталога: 
=== 2020-03-05 === 
14:44:47 [8аа7а13515] *СОВВЕМТ* к 1таех.В м1 подключён файл с таблицей 
стилей 1паех.сз5$ (изек: Гирозек1 фадз: Египк) 
=== 2020-03-04 === 
07:05:06 [3858а0865Е] добавлен стилевой блок (азег: Гирозек2 фадз: 
ЕхапК) 
=== 2020-03-02 === 
19:01:19 [а25ъЕ34850е] *РОВК* 1паех.ВЕм1 приведён к стандарту НТМЬ5 
(изег: Тшрозег2 фааз: Египк) 

07:13:30 [а8ера7176с] Добавлен НТМТ-шаблон 1паех.ВЕм1 (азег: ТШирозек1 
Садчз: Ехипк) 

=== 2020-02-29 === 

07:24:50 [24е23с5сЕЪ] 1п161а1 ешрЕу сВеск-1п (изег: ЗебарОзек 
Сачз: Екипк) 

+++ по моге Чаба (5) +++ 

Отметка *РОРК* (РАЗВИЛКА) определяет точку сохранения, в которой 
произошло ответвление. Отметка *СОВРАЕМТ* (ТЕКУЩАЯ) определяет текущую 
точку сохранения по отношению к рабочему каталогу. 

А как идут дела у второго верстальщика? Он как раз синхронизировал ре- 
позитории командой $$ 5упс и, в свою очередь, тоже получил предупреждение 
о возникшей развилке: 


бЗупс м1ЕН БЕ фр: //Тирозег2@Ео$$11.зекуег: 8081 / 
Воппа-Ег1рз: 2 АгЕ1Еас®з$ зепе: 0 гесе1уеа: 3 
бупс аопе, зепе: 1486 гесе1уеа: 1674 1р: 192.168.56.101 
жк МАБМТМах а Еогк Ваз. осситкеа. ***** 
изе "ЁЕо$$11 1еауез -та1Е1р1е" Еог шоке Чефа11$. 
Поскольку он пока не в курсе последних событий, то решил воспользо- 
ваться рекомендацией системы Е0$5Й и посмотреть подробности с помощью 
команды: 


Ео$$11 1еауез -ма1Е1р1е 
Она вывела на экран строки с описаниями последних загрузок конкури- 
рующих ветвей, возникших в результате развилки: 


ххх хор Кк ххх 

(1) 2020-03-05 14:44:47 [89а7а13515] к 1паех.66т1 подключён файл с 
таблицей стилей 1паех.сз5 (изег: Ттрозег1 фадз: Египк) 

(2) 2020-03-04 07:05:06 [3858а0865Е] добавлен стилевой блок (ипзег: 
Тирозек2 фадз: Ехапк) 
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Команда №0551 5бабаз показала, что текущей точкой сохранения для рабоче- 
го каталога верстальщика |трозег2 является загрузка с комментарием «добавлен 
стилевой блок», о чём свидетельствует отметка ситепе рядом с записью в пе- 
речне концевых узлов конкурирующих ветвей: 


тероз1фогку: .../Тирозег2/ззриерз1ее/..\ззрмерз1е-1оса1.ЁЕоз$11 
1Тоса1-коо®: .../Тирозек2/ззрмерз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ёо0$511 

срескойе: 388а0865Е8е4642сес82705Е5154а5649ас0са2 2020-03-04 
07:05:06 ОТС 

рагепф: а25Е34850еЕ82с40430е31183664еЁа0501е3 48а 2020-03-02 
19:01:19 ОТС 

Тачз: ЕгипК 


соптепе: добавлен стилевой блок (п5ег: Тирозег2) 
МАВМТМС: ша161р1е ореп 1еаЕ сВеск-1п$ оп Екипк: 
(1) 2020-03-05 14:44:47 [84а7а13515] 

(2) 2020-03-04 07:05:06 [38Ъ8а0865Е] (сиггеп®) 

Если сейчас не предпринять никаких мер, то проект будет развиваться в 
двух направлениях. Следующие загрузки верстальщиков будут записываться в па- 
раллельные ветки, всё дальше и дальше отдаляясь от точки, в которой произошла 
развилка, и тем самым уменьшая шансы достижения компромисса (рис. 4.12). 


© тре зоче-раде мебзйе Ти хо + я ы > 
< С О не защищено | 405$1.5егуег8 081 Аитете х © 
тре этае-раде меь$Ке / тиеме со 
= Ноте Титейпе Рез ВгапсВез 
Адуапсед |Модет Мел | Мах: 50 Свеск-пз у 
7 спескК-тз 
2020-03-05 
18:27 - 
р добавлен стиль основного шрифта веб-страницы 1. ва спескАп: 911970666Ризег |трозег1 1а95: лип 
18:22 = 
реализовано главное меню в заголовке веб-страницы 1еагспеск-п. 1096347е43 изег прозе? 1адз 
14:44 = — ь а 
к пдех. пил! подключён файл с таблицей стилей пдех.с$$ спеск-п: 84а7а13515 изег итрозег1 1а93- {пийй 
2020-03-04 
07:05 = Ск 
добавлен стилевой блок спеск-йп: 3853208651 изег: трозег2 1адз: гипк 
2020-03-02 
19:01 
ы пдех.Вт! приведён к стандарту НТМЕ5 спеск-п: 6251348506 изег. трозег? {ад3: лип 
07:13 = = 
} Добавлен НТМ! -шаблон тдех. пт! спеск-п: а82597176с изег. итрозег! 1а95: пиг 
2020-02-29 
07:24 
шика! етриу спеск-тп спеск-п: 24е23654 исег зашрИзег!0=: нип 


Рис. 4.12 
Разработка пошла двумя параллельными путями 
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На рисунке видно, что загрузка верстальщика |трозег1 с описанием «до- 
бавлен стиль основного шрифта веб-страницы» попала в левую ветвь, а загруз- 
ка верстальщика |трозег2 с описанием «реализовано главное меню в заголовке 
веб-страницы» —Щ в правую. Поскольку у нас не стоит задача получить два по- 
хожих продукта, то надо направить разработку в одно русло. 


4.2.8. Разрешение конфликта 


Когда разработчики не могут договориться между собой, в игру вступает 
начальство. Пришло время и менеджеру взглянуть на проект. 

Первым делом Мападег синхронизировал свой локальный репозиторий с 
сетевым с помощью команды 10$$й зупс. После этого он посмотрел шкалу вре- 
мени проекта с помощью команды 10$$1 Чте!пе. Вот что выдала эта команда: 
=== 2020-03-05 === 
18:27:11 [4911970666Е=] добавлен стиль основного шрифта веб-страницы 
(изек: ТирозегТ Еад5: Егопк) 


18:22:55 [Е0963а7еа3] реализовано главное меню в заголовке веб- 
страницы (изег: Ттрозег2 фадз: Егкипк) 


14:44:47 [89а7а13515] к 1паех.ВЕм1 подключён файл с таблицей сти- 
лей 1паех.с$$ (азег: Ттрозег1 бадз: Екипк) 

=== 2020-03-04 === 
07:05:06 [3858а0865Е] добавлен стилевой блок (изег: Ттрозег2 фадз: 
ЕхапК) 
=== 2020-03-02 === 
19:01:19 [492ъЕ34850е] *РОВК* 1паех.ВЕт1 приведён к стандарту НТМТ5 
(изег: Тшрозег2 фааз: Егкипк) 

07:13:30 [а8ефа7176с] *СОВВЕМТ* Добавлен НТМЬ-шаблон 1паех.ВЕи1 
(изек: ТирозегТ 6ада5: Егопк) 

=== 2020-02-29 === 
07:24:50 [24е23с5сЕЪ] 1101%1а1 ешрЕу сВеск-1п (азег: бебарОзек 
Тачз: Егапк) 

+++ по моге Чаба (7) +++ 


Поскольку менеджер не выполнял никаких операций над своим рабочим 
каталогом, не обновлял его содержимое и не загружал в репозиторий изменён- 
ные файлы проекта, отметка *СОВВЕМТ* (ТЕКУЩИЙ) осталась на точке сохра- 
нения, моментальный снимок которой был использован при создании рабочего 
каталога. 

Менеджер решил посмотреть, как выглядит проект в настоящий момент, 
для чего ввёл команду юз31 сНеской --1а{ез{. По этой команде система контроля 
версий переместила текущую отметку на последнюю по времени загрузку с 
идентификатором 911970666! (это результат работы верстальщика |трозег1) и 
выгрузила из репозитория в рабочий каталог файлы таех.пит! и паех.с$$, соот- 
ветствующие ей. 

Чтобы оценить работу верстальщика |трозег2, менеджер ввёл команду 
Го5$ свесКойе 0963а7еаЗ. По этой команде текущая отметка переместилась на 
загрузку с указанным идентификатором, и был выгружен соответствующий ей 
файл паех.И т! в рабочий каталог. Поскольку второй верстальщик не использо- 
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вал внешний файл для хранения таблицы стилей, то файл паех.сз$ из рабочего 
каталога был удалён. 

После просмотра обоих вариантов в веб-браузере менеджер пришёл к вы- 
воду, что проект ещё далёк от завершения, и он не может отдать предпочтение 
одному из них. Тогда он решил оценить объёмы проделанной работы каждым из 
верстальщиков, для чего запустил локальный веб-интерфейс командой 10$$Й ш 
.\5зруммебзКе-оса!1ю0$$Й и перешёл на шкалу времени по гиперссылке, представ- 
ленной пунктом меню Титете. 

Менеджер переместил указатель мыши на кружок, обозначающий точку 
сохранения 1трозег2 с комментарием «реализовано главное меню в заголовке 
веб-страницы», и щёлкнул левой кнопкой. Внутри кружка появилась красная 
метка. Затем он проделал то же самое с кружком, обозначающим точку сохра- 
нения |трозег1 с комментарием «добавлен стиль основного шрифта веб- 
страницы» (рис. 4.13). 


© тре эоче-раде мебзйе: Тит. Х + 5 Е ® 
= Сс @Ф юсато5 {тпейпе ж © 
тре зэтае-раде меь$Ке / теме мани цоя 
= Ноте Титейпе Рез Вгапспез Адтт 
Адуапсед |Модет \Мем | Мах]50 Снеск-тз * 
7 снеск-тз 
2020-03-05 
18:27 
1ь обавлен стиль основного шрифта веб-страницы Ева! спескАп: 9119706651 изег !трозег! 1адз: тип 
18:22 = 
реализовано главное меню в заголовке веб-страницы теа{спеск-п: 1096347е93 изег тпрозег2 {а0з 
4:44 Е = - : 
к таех.Р игл! подключён файл с таблицей стилей пдех.с$$  спеск-п: 847813515 изег !трозег1 1адз- ‘гипк 
2020-03-04 
07:05 Ра ре 
добавлен стилевой блок спеск-п: 3858208651 изег !трозег2 1адз- тип 
2020-03-02 
19:01 
’ идех.Вт! приведён к стандарту НТМЕ5 спеск-п: 425134850е изег !трозег2 1ад$5: (гипк 
07:13 — > 
Добавлен НТМЕ-шаблон тдех.Вт! снеск-п: а8е597176с изег ипрозег1 1адс: | 
2020-02-29 
07:24 
юпа! етрёу спеск-п спеск-п: 24е23с5с® изег: Заир 
Рис. 4.13 


Выполнение сравнения двух выгрузок 


В веб-браузере отобразилась страница с наглядным представлением раз- 
личий между выбранными точками сохранения (рис. 4.14). Менеджеру при- 
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шлось признать, что различия значительные и концептуальные, одной из ветвей 
разработки придётся пожертвовать. 


© тре эпче-раде меБзИе: СЕ Х + 


< С ОФ ссаво5Е808 буди тот=096347е932083%810=411970666{е0е 


ОЧегепсе Егот: 


[096347еа3] реализовано главное меню в заголовке веб-страницы (изег: |прозег2, {ад 
{гипК, дае: 2020-03-05 18:22:55) 


То: 


[9119706661 добавлен стиль основного шрифта веб-страницы (изег: прозе! 1, 1адз: гипК, 
дае: 2020-03-05 18:27:11) 


АДдечд 1пдех.с$$ мегзюп [20сс465851 


* {иасё1т: 0; раба1а: @} 
Бобу {+01: погиа| погка1 погпа1 108% запь-зег1е} 


Мод\ед пдех. пит! гот [084175406] 4о [5себ010с5а] 


уре Не 
и] 1аив=”гиы 


1 
5тузе 
* {пагбаи: 8; раба1тв: 8} 
езде { 

Баскигомы: вгау; 

Баскагоита: Илезг-вгабети(1о бор, 000, 47РР); 


} 

Мезбег пам { 
ФопЕ-меции: 8914; 
ФопЁ-Цесога ов: ипдессоге 


езаег вау ы1 1 а:Вомег {теже-десогаЕ от: ипбег 11а} 
Бездег пам ы1 1 {агыап-1е#1: 2е0; 155-51у1е-(уре: воде; Чар1ау: 1 е} 
Зезбег пам ш1 11141751-СВ13 (вагайо-гаани: бев) 

</зту1е> 

пеза 


воау 
<вездег> 
<пау 
< 
414242 Вге+="0ъес 11" ›Соарапу</2></11> 
"ъеск2”обесАтой 1</а22</11> 


вес” ›бес11от 2</2>«/11> 

«11256 Пге+-"бъес 4” бес Цой 3«/а>«/ > 

413><е Вге+=" кет" бесп 4</а></И> 
<> 
</пам> 


<11>Простое од"остраничное веб-приложение</№1> 


1 Вы 


Рис. 4.14 
Различия между конечными состояниями двух ветвей проекта 

«Работа проделана большая, но так дело не пойдёт!» — подумал мене- 
джер, ознакомившись с вариантом второго верстальщика. Идея размещения 
стилей в НТМГ-файле, пусть и в отдельном блоке, ему не понравилась. Совме- 
стить весь проект в одном файле всё равно не получится, потому что веб-сайт 
как минимум будет содержать графические элементы, а вынос параметров 
оформления в отдельный файл упростит как разработку, так и дальнейшее со- 
провождение. 

В качестве основы для развития проекта менеджер выбрал вариант вер- 
стальщика |трозе!1. Технически для этого ему понадобилось выполнить следу- 
ющие действия. 
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Во-первых — сделать текущей ту точку сохранения, к которой будет при- 
ведён проект и от которой будет осуществляться его дальнейшее развитие. Это 
было выполнено командой: 


Еоз$11 срескойЕ &911970666Е 


где 9119706661 — идентификатор точки сохранения. 
Во-вторых — присоединить точку сохранения бесперспективной, по мне- 
нию менеджера, ветви к текущей точке сохранения: 


05511 шегае --1п6едгаее Е0963а7еа3 


В этой команде Ю963а7е93 — идентификатор точки сохранения присоеди- 
няемой ветви. Поскольку присоединяемую ветвь в дальнейшем развивать не 
планируется, то команда слияния дополнена опцией --йиеотае — она завершит 
присоединяемую ветвь, запретив в неё дальнейшие загрузки. 

Для команды слияния 35! тегде имеется ещё опция --раскои, которая 
наряду с завершением присоединяемой ветви заставляет полностью игнориро- 
вать накопленные в ней с момента развилки изменения. Эту опцию можно было 
бы использовать, если бы решено было развивать вариант верстальщика 
|прозег2. Но в файле таех.пт, который предложил второй верстальщик, поми- 
мо неудачного решения с размещением оформления в стилевом блоке имеется 
интересная наработка относительно организации главного меню в заголовке 
веб-страницы, которую можно использовать в дальнейшем. 

В результате выполнения операции слияния ветвей было выдано сообще- 
ние: 


Апбозупс: ВЕЕр: / /Марадег@Ео35$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Ра11 аопе, зепе: 361 геселуеа: 821 1р: 192.168.56.101 

МЕВСЕ 1паех.ВЕп1 

ххххх 1] пшегае сопЕ11се5 1п 1паех.Веи1 

МАВМТМС: 1 шегде сопЕ11се$ 

"Ео$$11 ипао" 1$ ауа11аб1е во ипао сВапаез во ЕБе могК1па срескойе. 


Из сообщения понятно, что конфликт слияния ветвей произошёл в файле 
шаех.нит!. Открыв его в текстовом редакторе, менеджер увидел такую картину: 


Файл таех.й и после попытки слияния 


<!аосбуре ВЕп1> 
<рем1 1апад="хги"> 
<реаа> 
<6161е>51ир1е з1па1е-раде мерз16е</е1Е1е> 
<тефа свагзее="аеЕ-8"> 
<<<<<<< ВЕСТМ МЕВСЕ СОМЕТТСТ: 1оса1 сору зВомп Е1квЕ <<<<<<<<<<<<< 
<11пК ВкеЕ="1раех.сзз" ге1="зсу1езтеее" фуре="Еехе/сзз"> 
</Беаа> 
======= СОММОМ АМСЕЗТОВ сопеепЕ Ео11о0ом5 
</веаа> 
======= МЕВСЕР ТМ сопбепе Ео11о0и5 
<56у1е> 
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* {пагда1п: 0; рааа1та: 0} 
реааег { 
РаскакоипЯ: дгкау; 
Баскагойпа: 11пеаг-дгаЧ1еп® ($о бор,#р00, #ЕЕЁ) ; 
} 
Геааегк пах { 
ЕопЕ-метзаре: ро1а; 
ЕопЕ-аесогха®1оп: ипаегсоге 
} 
Беааег паху 91 11 а:Боуег {Еехе-аесога®1от: пипаек11пе} 
Беадехг пам 1 11 {таколп-1еЁЕ: 2ет; 11$&-з6у1е-буре: попе; 91$р1ау: 1111пе} 
Веааек пау 11 11:Е1:56-ср11А {пага1п-г1аре: бет} 
</зЕу1е> 
</пеаа> 
>>>>>>> ЕМО МЕВСЕ СОМЕБТСТ >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
<Боду> 
<Веааег> 
<па\у> 
<и1> 
<11><а ргеЕ="#зес®1">Сопрапу</а></11> 
<11><а пгеЕ="#зесе2">5есе1оп 1</а></11> 
<11><а БгеЕ="#зесё3">5есе1оп 2</а></11> 
<11><а ргеЕ="#зесе4">5$есЕ1оп 3</а></11> 
<11><а пгеЕ="#зесе5">5есе1оп 4</а></11> 
</и1> 
</па\> 
</Беааетх> 
</Боау> 
</вЕт1> 


Строка ВЕСИМ МЕВСЕ СОМЕНСТ: |оса! сору зПомт #гз{ отмечает начало тек- 
стового блока, в котором произошёл конфликт слияния и информирует о том, 
что непосредственно после неё идут строки из локальной копии файла — той, 
которая находилась в рабочем каталоге перед слиянием. И действительно, мы 
видим строку, ответственную за подключение файла таех.сз$, содержащего 
стилевое оформление. 

Строка СОММОМ АМСЕЗТОВ сощеп! юЮ!омз отмечает начало текстового 
блока, содержащего строки общего предшественника для локального и вливае- 
мого файлов. 

Строка МЕАСЕО !№ сощепЕ ю!омз содержит блок текста из вливаемого 
файла, который конфликтует (пересекается) с текстом, находящимся в локаль- 
ной копии файла на момент слияния. Это как раз тот стилевой блок, который у 
второго верстальщика размещён на месте строки, подключающей недавно упо- 
мянутый файл тдех.сз$. 

Строка ЕМО МЕВСЕ СОМЕМСТ отмечает конец области конфликта. 
В оставшейся части текстового файла находятся строки, ради которых проводи- 
лось слияние — ответственные за формирование горизонтального меню в заго- 
ловке веб-страницы. 

Ознакомившись со структурой файла таех.вт!, сформированного систе- 
мой Ео$51 при попытке совмещения двух вариантов, он сделал следующее: 
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1) перенёс описания стилей из стилевого блока в файл таех.с$$; 

2) удалил из тпаех.И{т! строки, содержащиеся между отметками СОММОМ 
АМСЕЗТОН сощеп{ ю1омз$ и ЕМО МЕВСЕ СОМЕЦСТ вместе с самими отметками; 

3) удалил строку с отметкой ВЕСИМ МЕРСЕ СОМЕНСТ: оса! сору зНомт #г$Е; 

4) удалил альтернативные варианты файлов таех.пт|, созданные в рабо- 
чем каталоге системой Ео$$1, с помощью команды @е| *-* (на системах ОМГХ 
надо выполнить команду гт *-*). 

В результате файл тадех.И т! приобрёл вид: 


Файл таех ит после ручной доработки 


<!аосЕбуре ВЕп1> 
<рем1 1апад="ги"> 
<реаа> 
<6161е>51ир1е з1па1е-раде мерз16е</&1Е1е> 
<тефа свагзее="аеЕ-8"> 
<11пК ВкеЕ="1раех.сзз" ге1="зсу1езреее" фуре="Еехе/сзз"> 
</Беаа> 


<Боду> 
<Беааек> 
<па\у> 
<и1> 
<11><а ргеЕ="#зес®1">Сопрапу</а></11> 
<11><а пгеЕ="#весе2">5есЕ1оп 1</а></11> 
<11><а ВгеЕ="#зесе3">бесЕ1оп 2</а></11> 
<11><а пгеЕ="#зес&4">5есЕ1оп 3</а></11> 
<11><а ВгеЕ="#зесе5">бесЕ1оп 4</а></11> 
</и1> 
</пау> 
</веа4ег> 
</Боау> 
</вЕт1> 


А файл таех.с$$ стал выглядеть так: 


Файл таех.с55 после ручной доработки 

* {пага1п: 0; рааа1та: 0} 
роау {ЕопЕ: погма1 погма1 погща1Т 100% запз-зег1 ЕЁ} 
феааехг {расКагопспа: ахау; Баскагопра: 11пеаг-дга лете (Фо бор, #000, #ЕРЕЕ) } 
БеаЧек пау {ЁЕоп&-мезаре: ро1а; Еопе-Чесога&1оп: ипаегсокге} 
Беааег пау 91 11 а:Боуегк {ЕехЕ-аесога®1оп: ппаек11пе} 
Беадег пау и1 11 {пагалп-1еЕе: 2ет; 1156-з6у1е-6буре: попе; 915р1ау: 1п111е} 
Веа4ек пау 11 11:Е1:756-ср11А {пагд1п-г1аре: беп} 

После выполненных изменений команда №ю$$1 за з показывает такой ре- 
зультат: 


тероз1огу: .../Мападек/мерз1ее/.. \ззриебз1Ее-1оса1.ЁЕоз$11 
1оса1-кооф: .../Марадек/мебз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 

срескойе: 911970666Ее0е0Е28639039Е419Е8а260с5283р1 2020-03-05 18:27:11 ОТС 
рагепе: 84а7а1351560с6ю6а24195652575571371058100 2020-03-05 14:44:47 ОТС 
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Кач: ЕкипкК 

соптепе: добавлен стиль основного шрифта веб-страницы (и5ег: Тиро5ет1) 
ЕОТТЕР 1паех.с$55 

ЕОТТЕОР 1паех.ВЕи1 


ТМТЕСВАТЕ 
Е0963а7еа32083ЕЮса790З3Е85бааа4 Э9а18е1 584Е2сбберее7ЕбаЕЬЗ35са575111 


МАВМТМС: по161р1е ореп 1еаЁЕ сВеск-1п$ оп ЕкипкК: 
(1) 2020-03-05 18:27:11 [а911970666Е] (сикгеп®) 
(2) 2020-03-05 18:22:55 [Е0963а7еа3] 


Третье, и последнее, что осталось сделать менеджеру для решения кон- 
фликта, — загрузить результат проделанных операций по слиянию ветвей про- 
екта в репозиторий: 

Ео5$11 сопш1е -ш "выбрано направление дальнейшего развития проекта" 

После вмешательства менеджера шкала времени сетевого репозитория 
приобрела вид, показанный на рисунке 4.15. 


— О х 
©® тре эпае-раде меБ5Ие: Тит. хо + 
= С О не защищено | 105$1.5егуег8081Айтейте & о 
. . . 
тре зэта!е-раде ме з$Ке / тоже год 
= Ноте Титейпе ЕИез Вгапспез 
АЧуапсед | Модет \Мем * | Мах150 Свеск-тз т 
8 снеск-ит5 
2020-03-07 
09:56 = 
выбрано направление дальнейшего развития проекта 
Геаг спеск-п: с739/с9а25 изег. Мападег1адз: 1пипк 
2020-03-05 
18:27 ы - 
добавлен стиль основного шрифта веб-страницы  спескуп: 9119706651 изег |трозег! 1адз: гипк 
18:22 ‚2 
реализовано главное меню в заголовке веб-страницы 
спеск-п: 096397е43 изег. трозег2 {адз: {пик 
14-44 = - = > =. 
к паех. Вт! подключён файл с таблицей стилей тдех.с$$ 
спеск-п: 8437а13515 изег: итрозе:1 1205: пипк 
2020-03-04 
07:05 г а 
добавлен стилевой блок спеск-п: 3808208651 изег. 1трозег2 1адз; гипк 
2020-03-02 
19:01 
пдех.Рпт! приведён к стандарту НТМЕ5 спеск-п: 925134850е изег. ипрозе2 1ад5: {гипк 
07:13 = = 
Добавлен НТМЕ-шабпон пдех.Ригт! спеск-1п: а8е697176с изег. трозег1 1адз: {пипк 
2020-02-29 
07:24 з ь 
ша! етр!у спеск-п спеск-п: 24е23с5с® узег ЗеирИзег{адз: {пипк 


Рис. 4.15 
Шкала времени после слияния ветвей проекта 
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Эту же шкалу времени можно увидеть в окне командной строки, если 
воспользоваться командой юз31 итепе: 
=== 2020-03-07 === 
09:56:15 [с78аЕс9а25] *МЕВСЕ* *СОВВЕМТ* выбрано направление даль- 
нейшего развития проекта (изег: Мападег фадз: Екипк 
=== 2020-03-05 === 
18:27:11 [4911970666] добавлен стиль основного шрифта веб-страницы 
(изек: ТирозегТ 6ад5: Егопк) 
18:22:55 [Е0963а7еа3] реализовано главное меню в заголовке веб- 
страницы (изек: Тирозег2 фааз: Екапк) 
14:44:47 [89а7а13515] к 1паех.ВЕм1 подключён файл с таблицей сти- 
лей 1п4ех.сз5 (изег: Тирозек1 фааз: ЕгипкК) 
=== 2020-03-04 === 
07:05:06 [3858а0865Е] добавлен стилевой блок (изег: ТГрозег2 $адз: Егапк) 
=== 2020-03-02 === 
19:01:19 [492ЪЕ34850е] *РОВК* 1паех.6м1 приведён к стандарту НТМТЬ5 
(изег: Тшрозег2 фааз: Египк) 
07:13:30 [а8ебра7176с] Добавлен НТМТ-шаблон 1паех.6Ем1 (азег: Ти- 
розек1 Еадз: Екипк) 
=== 2020-02-29 === 
07:24:50 [24е23с5сЕЪ] 1111а1 ешрфу спеск-1п (изег: ЗебарИзег бадз: Е гапк) 
+++ по шоге Чаба (8) +++ 


Отметка *РОАК* помогает понять, где произошло разветвление проекта, а 
отметка *МЕВСЕ* — где произошло слияние. 


4.2.9. Альтернативное разрешение 


К этому моменту читатель, вероятно, уже недоумевает по поводу того, ка- 
кой значительный объём технической работы проделал менеджер для решения 
конфликта, возникшего между верстальщиками. На самом деле у менеджера 
хватает дел по управлению проектом и не всегда есть достаточная квалифика- 
ция, чтобы компетентно править исходный код. 

Но в рамках этой книги предположим, что менеджер — в недавнем про- 
шлом лидер команды разработчиков, решивший попробовать себя в новом ста- 
тусе. Тем более что проект небольшой, и в возникшем конфликте он нашёл для 
себя возможность тряхнуть стариной. Поэтому отложим организационные во- 
просы, а сосредоточимся на технической стороне дела. 

Более того, предположим, что в параллельной вселенной менеджер после 
анализа ситуации вокруг конфликта стал на сторону верстальцика |трозег2 и 
решил пожертвовать работой первого верстальщика, потому что тот набрал все- 
го несколько строк. Вот что предпринял менеджер в этом случае. 

Во-первых, он сделал текущей последнюю точку сохранения верстальщи- 
ка |трозег1 с помощью команды: 


Еозз11 сБескойпЕ Е0963а7еа3 


где 096397е43 — идентификатор точки сохранения. 

Во-вторых, он присоединил последнюю точку сохранения ветви вер- 
стальщика |трозег2 к текущей точке сохранения с указанием отбросить все из- 
менения, выполненные в этой ветви с момента развилки. Для этого менеджер 
дополнил команду слияния опцией --Баскоиг: 
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Ео5$511 шегае --БасКкойЕ а911970666Е 


где 9119706661 — идентификатор точки сохранения прерываемой ветви. 
В-третьих, он загрузил результат проделанных операций по слиянию вет- 

вей проекта в репозиторий. Поскольку в файлы рабочего каталога никаких из- 

менений не вносилось, команду выгрузки следует дополнить опцией --аЦом- 

етру: 

Ео$$11 сошт1е а11ом-ешрЕу -м "выбрано направление дальнейшего 

развития проекта" 


После вмешательства менеджера шкала времени сетевого репозитория 
приобрела вид, показанный на рисунке 4.16. Пунктирной линией обозначена 
фиктивная загрузка, не содержащая изменённых файлов, но отражающая слия- 
ние ветвей проекта. 


= | х 
@ тре эпо-раде мебзИе: Ти" Хх + 
— @ © Не защищено | #05$1.5егуег:8 081 /итейте х о 
В . В 
тре зтае-раде меь$Ёе / тео со 
= Ноте Титейпе ЕИез Вгапспез 
АЧуапсед | Модет \Мем *| Мах]50 Снеск-тз у 
8 спеск-т5 
2020-03-06 
16:12 г - 
выбрано направление дальнейшего развития проекта 
ГеаГ спеск-п: 57а1е34ада изег Мападег1ад$: {тип 
2020-03-05 
18:27 - 
ы добавлен стиль основного шрифта веб-страницы 
ГеаЕспеск-п: 4119706661 изег. итрозег1 1295: тип# 
8:22 2 
реализовано главное меню в заголовке веб-страницы 
спеск-п: 096347293 изег: итрозег2 {адз: 1пипк 
14-44 м ь ы - 
к мдех. Вит! подключён файл с таблицей стилей пдех.с$$ 
спеск-п: 84а7а13515 изег: пзрозег1 1ад$: гипк 
2020-03-04 
07:05 г в 
добавлен стилевой блок спеск-шп: 3858 а0865Гизег. ипрозег2 {1а05: Члипк 
2020-03-02 
19:01 
шдех.Рт! приведён к стандарту НТМЕ5 спеск-п: 4234850е изег. ипрозег2 1адз: 1типк 
07:13 я 
Добавлен НТМ! -шабпон тпаех.Вт! спеск 176с изег ипрозег1 {а0$: типк 
2020-02-29 
07:24 
шма! етр!у спеск-п спеск-п: 24е23с56 изег: ЗеирИзег {адз: гипк 


Рис. 4.16 
Шкала времени после слияния конкурирующих ветвей 
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После слияния двух параллельных ветвей проекта его участникам следует 
выполнить обновление своих локальных репозиториев (с помощью команды 
0551 зупс или Ю$$1 ри!) и рабочих каталогов (с помощью команды ю$$Й ирдае). 
При коллективной разработке эти действия лучше производить более-менее ре- 
гулярно, чтобы иметь актуальное состояние проекта на своём рабочем месте. 
Это уменьшит вероятность наложений несовместимых изменений, хотя, конеч- 
но, не сможет полностью их исключить. Как решать возникающие при этом 
конфликты — в общих чертах было рассмотрено выше. 

На этом рассмотрение примера возникновения и решения конфликта за- 
вершено. Пришло время подвести итоги и систематизировать полученные све- 
дения. 


4.2.10. Уроки конфликта 


На первый взгляд может показаться, что решение конфликтов, возникших 
в ходе разработки, через систему контроля версий требует слишком больших 
усилий. Небольшие команды, которые до сих пор не пользуются специализиро- 
ванными системами, а просто держат исходные тексты в общедоступном фай- 
ловом хранилище, могут заявить, что подобные конфликты у них исключены 
договорённостями и соглашениями, действующими среди участников проекта. 
Работа же через систему контроля версий несёт с собой большие накладные 
расходы в виде ритуалов синхронизации репозиториев и постоянного контроля 
над текущим состоянием проекта. 

Такие заявления кажутся справедливыми лишь на первый взгляд. Даже 
если работа над проектом распределена между его участниками так, чтобы ис- 
ключить изменение одних и тех же файлов разными разработчиками, система 
контроля версий станет жёстким каркасом, направляющим разработку. Кроме 
того, возникновение отдельных инцидентов нельзя исключать, и если без си- 
стемы контроля версий один разработчик может просто переписать файл с ре- 
зультатами работы своего коллеги, то в системе контроля версий этот инцидент 
будет незамедлительно обнаружен, а усилия по управляемому решению воз- 
никшего конфликта, скорее всего, предотвратят крупные проблемы, которые 
могли бы возникнуть в дальнейшем. 

Кроме гарантирования целостности проекта в ходе разработки система 
контроля версий обеспечивает хранение всей истории его изменений. С помо- 
щью команды Ю3$Й спескощ можно получить все файлы проекта и в том виде, в 
каком они существовали на момент создания точки сохранения. Никто не за- 
прещает создать несколько рабочих каталогов, открыть из них один и тот же 
файл локального репозитория с помощью команды {10$$1 ореп и выгрузить в эти 
рабочие каталоги из репозитория файлы проекта, соответствующие разным точ- 
кам сохранения. Такая модель использования позволяет получить полное пред- 
ставление о состоянии проекта на разных этапах его исторического развития 
или одновременно вести разработку нескольких параллельных ветвей (напри- 
мер, для проверки нескольких возможных вариантов реализации нетривиальной 
функциональности). 
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Обнаружение при выгрузке актуального состояния репозитория в свой 
рабочий каталог командой 10551 ирдае перекрывающихся изменений факта, что 
файл, над которым велась работа, одновременно был модифицирован другим 
участником проекта, — момент неприятный, но не трагичный. Система Ро$$! 
делает всё возможное, чтобы упростить консолидацию конфликтующих версий. 

Во-первых, она создаёт в рабочем каталоге три варианта файла, вызвав- 
шего проблему: 

® с суффиксом -ойдта! — локальный файл, который присутствовал в ра- 
бочем каталоге на момент получения обновления; 

® с суффиксом -тегде — файл из репозитория, который изменён другим 
участником проекта; 

® с суффиксом -Базете — файл, содержащий лишь общие для предыду- 
щих двух вариантов части. 

Во-вторых, она аккуратно вставляет конфликтующие блоки в нужные ме- 
ста локального файла, сохраняя их последовательность и снабжая комментари- 
ями. Как правило, для решения конфликта разработчику остаётся просмотреть 
эти участки, продумать план консолидации и исправить файл, учитывая интере- 
сы участников конфликта. 

В большинстве случаев система Ео$$ позволяет откатить изменения в 
рабочем каталоге, вызванные выполнением последней команды. Для этого надо 
ввести команду: 


Ео$$11 апао 


Например, верстальщик |трозег2 находится ещё в неведении относитель- 
но решения, принятого по поводу его варианта работы, о чём говорит команда 
Ю$$Й чае: 


тероз1фогку: .../Гирозек2 /ззрмерз1ее/..\ззрмерз1е-1оса1.ЁЕоз$11 
Тоса1-коо®: .../Ттрозег2/ззрмерз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 

срескойе: Е0963497еа32083Е5са7903Е8Ъбаа949а18е1584{ 2020-03-05 18:22:55 Ч9ТС 
рагепе: 3858а0865Е8е4642сес82705Е5154а5649ас0са2 2020-03-04 07:05:06 ПТС 
пегаед-1п6о0: с78аЕс9а256с15с2е02692а0Е96ю2014071ае53 2020-03-07 09:56:15 ЧТС 
ачз: ЕгипкК 

сошмепе: реализовано главное меню в заголовке веб-страницы (изег: Тирозег2) 


Но при очередном получении обновлений проекта из репозитория в рабо- 
чий каталог с помощью команды $51 ирдае он увидел такие сообщения: 


Апбозурс: ВЕЕр://Ттрозег2@Ео$$11.зекуег: 8081 / 

Коппа-:1рз: 1 АгЕ1Еасе$ зепе: 0 геселуеа: 0 

Рои11 аопе, зепе: 396 геселуеа: 932 1р: 192.168.56.101 

АБР 1паех.сз$ ДОБАВЛЕН 1паех.с$$ 

ОРРАТЕ 1паех.6&и1 ОБНОВЛЁН 1пдех.ВЕт1 

ирааееа-Фо: с789Ес9а256с15с2е02692а0Еа6р2014071рае53 2020-03-07 09:56:15 ОТС 
Кач: ЕкгипкК 
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соптепе: выбрано направление дальнейшего развития проекта (изег: Мападег) 
срапдез: 2 Е11ез шоа1Е1еа. 2 файла изменены. 
"Ро5511 ипао" 15$ ауа11аБ1е Фо ипао спапдез во ЕПе могк1лпа сцВескоче. 


И действительно, в рабочем каталоге появится файл таех.сз$, а файл 
паех.п т! будет представлен в том варианте, каким его загрузил в репозиторий 
менеджер при решении конфликта. Если по какой-то причине результат загруз- 
ки обновлений верстальщика не устраивает, он может выполнить команду: 


Ео$$11 апао 


На экран будут выведены сообщения: 


РЕТЕТЕ 1паех.сз$з УДАЛЁН 1паех.с55 
ОМРО 1паех.66м1 ВОССТАНОВЛЕН 1паех.6Еи1 


ирааЕеа-Фо: Е0963а97еа32083ЕЪса7903Е856аа949а18е1584Е 2020-03-05 18:22:55 ОТС 
Тачз: ЕгипК 


соптейе : реализовано главное меню в заголовке веб-страницы (изегк: Гирозег2) 


После отката рабочий каталог будет возвращён в состояние, которое 
предшествовало выполнению команды 105$ ирдае. 

Если при выполнении команды ю5$$й ирдае система обнаружит, что репо- 
зиторий не содержит ничего, что отличалось бы от содержимого рабочего ката- 
лога, то в строке сВапее$ (изменения) будет выведено сообщение: Мопе. Агеаду 
ир-ю-аае (Ничего. Уже актуально). 

Уже отмечалось ранее, но будет не лишним напомнить, что работа с сете- 
вым репозиторием осуществляется опосредовано, через локальный репозито- 
рий. Команда 1ю$$й зупс выполняет двухстороннюю синхронизацию локального 
и сетевого репозиториев: 

® получает изменения из сетевого репозитория в локальный (Ю$$1 ри); 

® отправляет изменения из локального репозитория в сетевой (103$й ризпП). 

Выполнение синхронизации никак не влияет на состояние рабочего ката- 
лога. Информационный обмен между рабочим каталогом и репозиторием ини- 
циируется другими командами: 

® 1055 соттй — загрузка мгновенного снимка рабочего каталога в репо- 
зиторий с созданием в последнем точки сохранения; 

® 1055! ирдае — выгрузка актуального состояния из репозитория в рабо- 
чий каталог с наложением на него выполненных локально, но ещё не загружен- 
ных в репозиторий изменений; 

® 055 спескош — выгрузка сохранённого состояния из репозитория в ра- 
бочий каталог с утратой выполненных локально, но ещё не загруженных в ре- 
позиторий изменений. 

Установленный по умолчанию режим автоматической синхронизации 
приводит к тому, что выполнение команд информационного обмена между ра- 
бочим каталогом и репозиторием запускает процедуру синхронизации локаль- 
ного репозитория с сетевым. 
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4.3. Параллельная разработка 


4.3.1. Разветвления и ответвления 


Из рассмотренного примера может сложиться впечатление, что разветвле- 
ние линии развития проекта — это что-то нежелательное, вызванное какими-то 
несовместимыми изменениями и требующее арбитража. Так и есть, появление 
ветви из-за невозможности бесконфликтного слияния изменений, внесённых в 
файлы проекта его участниками, — это форс-мажор, который надо как можно 
быстрее устранить. Для такой ситуации в системе контроля версий использует- 
ся термин ЮтК. 

Но в реальной практике нередки случаи, когда участник проекта может по 
собственному желанию создать ответвление от главной линии развития. Причин 
тому может быть несколько: 

® одновременная разработка нескольких функций; 

® отсутствие уверенности в правильности изменений, которые предстоит 
внести; 

® испытание нескольких вариантов реализации одной и той же функции; 

® тестирование программного продукта перед выпуском; 

® сопровождение выпущенной в промышленную эксплуатацию версии 
программного продукта. 

Коллективная работа над проектом подразумевает разделение труда. Луч- 
ше всего, если есть возможность выдать участникам проекта независимые зада- 
ния, над которыми они могли бы работать одновременно. Прекрасно, если каж- 
дый разработчик при этом будет вносить изменения только в свои наборы фай- 
лов. Отразить ведение параллельной разработки в системе контроля версий 
можно созданием для каждого задания отдельной ветви. По мере выполнения 
заданий наработки из ветвей вливаются в основную ветвь проекта, постепенно 
доводя его до готовности. 

Если разработчик заранее не уверен в правильности выбранного направ- 
ления развития проекта, то лучше сразу зафиксировать это сомнение путём вы- 
вода дальнейшей разработки в отдельную ветку. Такой подход упростит возврат 
к точке сомнения в случае, если подтвердятся негативные ожидания. А если со- 
мнения окажутся напрасными, то не составит никакого труда внедрить резуль- 
таты работы в рамках созданной ветки в основную ветвь проекта. 

Одним из вариантов отсутствия уверенности может быть испытание в ра- 
боте над реальным проектом практиканта или новичка команды. Лучший вари- 
ант введения в курс дела нового человека — предложить ему выполнить кон- 
кретное задание. А чтобы работа над ним не помешала остальным членам ко- 
мадны, для реализации этого задания можно создать отдельную ветвь в репози- 
тории. В случае успеха реализованная функция будет принята в основную 
ветвь, а в случае неудачи можно попытаться разобраться с её причинами, про- 
анализировав точки сохранения выделенной ветви. 

Некоторые функции могут быть реализованы несколькими способами. 
Простейший пример — сортировка массива данных. Разные методы сортировки 
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могут показать различную производительность в зависимости от вида исходных 
данных. Если это является принципиальным, то можно реализовать несколько 
методов, а потом протестировать работу системы с каждым из них и выбрать 
наиболее эффективный. Работу над каждым альтернативным методом удобнее 
всего вести в отдельной ветви проекта. 

В какой-то момент разработки принимается решение о том, что продукт 
созрел для выпуска в эксплуатацию. На этом этапе фиксируется набор функций, 
которые делает программа, и выполняется только шлифовка с устранением 
ошибок. В то же время выпускаемая версия может быть не окончательной, если 
имеются планы относительно дальнейшего развития продукта. В этом случае 
уместно выделить работу над ней в отдельную ветку, а разработку перспектив- 
ных функций для следующих выпусков продолжать в основной ветви. 

В выпущенных программах почти всегда обнаруживаются недостатки. 
Если не было создано ответвления перед выпуском продукта, разумно его со- 
здать в случае появления необходимости его доработки после выпуска. В любом 
случае лучше отделить работу над программой с зафиксированной функцио- 
нальностью от работы над продолжением развития программного продукта. 

Все рассмотренные примеры объединяет одно: решение о создании ветки 
в разработке проекта принимается осознанно и не для устранения последствий 
аварии, а превентивно, для улучшения управляемости процесса разработки. 
Ветви разработки, которые возникают как в результате таких ответвлений, так и 
в результате разветвлений, произошедших из-за форс-мажорных обстоятельств, 
в системе контроля версий обозначают термином БгапсВ. Несмотря на то, что 
причины их происхождения различны, дальнейшая работа с ветвями произво- 
дится одинаково. 


4.3.2. Создание ответвлений 


После решения конфликта, который, как мы помним, произошёл из-за 
различных взглядов верстальциков на способ подключения стилевого оформ- 
ления к веб-сайту, менеджер проекта решил принять организационные меры 
для уменьшения вероятности таких накладок в дальнейшем. Он предложил вер- 
стальщику трозег2, который начал разработку главного меню в заголовке веб- 
сайта, продолжить работу и заняться заголовком страницы в целом. А вер- 
стальщику трозег1 предложил заняться основным содержимым веб-сайта. 

Узнав об отсутствии у верстальциков возражений относительно распре- 
деления задач, менеджер решил отразить принятое решение в репозитории про- 
екта путём создания двух ветвей — по одной для каждой поставленной задачи. 
Прежде всего ему понадобилось узнать идентификатор точки сохранения, в ко- 
торой предстоит сделать запланированные ответвления. Он воспользовался ко- 
мандой: 

Еоз511 Е1те11пе -п 1 


С помощью параметра -п менеджер ограничил выдачу одной последней 
записью и получил интересующие его сведения: 


=== 2020-03-07 === 
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09:56:15 [с78аЕс9а25] *МЕВСЕ* *СУОВВЕМТ* выбрано направление даль- 
нейшего развития проекта (изег: Мападег фадз: ЕкипкК) 


—-- епЕеку 11116 (1) геасфеа --- достигнут предел записей (1) 


Теперь в точке сохранения с идентификатором с789\9а25 можно создать 
ответвление для работы над заголовком веб-страницы: 


Еоз$11 ЮкапсЬ пем заголовок с784Ес9а25 


В выполненной команде заголовок — это имя для создаваемой ветви. При 
разветвлениях, которые происходят в результате конфликтов, возникающие вет- 
ви обычно безымянны. Если же ответвление производится преднамеренно, то 
уместно назвать создаваемую ветвь так, чтобы было понятно её назначение. 
В результате выполнения команды на экран была выведена следующая инфор- 
мация: 


Мм Югапср: 93591744573976е1с25811аеее 1ас5982а666546а9аЕр4Еа1152442За4а8а7а 
Апбозупс: ВЕ: / /Марадег@Еоз5$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 1 гесе1уеа: 0 

Ризр аопе, зепёе: 1290 гесе1уеа: 281 1р: 192.168.56.101 


В первой строке указан идентификатор созданной ветви, он же — иден- 
тификатор её первой точки сохранения. Остальные строки содержат служебную 
информацию о произошедшей при выполнении команды синхронизации репо- 
зиториев. Аналогичным образом создаётся вторая ветвь — для работы над со- 
держимым веб-страницы: 


Еоз$11 Бхапср пем содержимое с78аЕс9а25 


Полученный ответ такой же, как в результате выполнения первой коман- 
ды, за исключением фактических значений: 


Мем Ргапср: 99с308408924са99се8а39с2Е79Е512'70раа443942753е6541рс59Е0ебЕ6ЕЗЗа7 
Апбозупс: ВЕ: / /Марадег@Еоз5$11.зегуег:8081/ 

Воипа-Ег1рз: 1 АкЕ1Еасё5 зепЕ: 1 кеселуеа: 0 

Ризр аопе, зепёе: 1332 гесе1уеа: 281 1р: 192.168.56.101 


После создания ответвлений на шкале времени проекта в дополнение к 
основной ветви, которая называется {гипк, появились ветви «заголовок» и «со- 
держимое» (рис. 4.17). 

При преднамеренном ответвлении с помощью команды 10$$Й бгапсН пем 
происходит копирование точки сохранения, из которой вырастает ветвь, в точку 
сохранения, которой новая ветвь начинается. В приведенном примере точкам 
сохранения с идентификаторами с7899а25, 9369174467 и 993084089 соответ- 
ствуют одинаковые моментальные снимки рабочего каталога. 

Несмотря на это, участники проекта должны переключиться на ту ветвь, 
которую они будут развивать. Верстальщик |трозег1 выполнил команду Ю$$й 
ирд4ае, чтобы актуализировать состояние своего рабочего каталога, и посмотрел 
последние три события в истории развития проекта с помощью команды: 


Ео$$11 Е1ме11пе -п 3 
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х 


© тре зтае-раде меБзИе: Тит + 


< 


С О не защищено | 1055й,5егуег:8081/утейпе 


Ноте Титейпе Ре; Вгапспез 


Адуапсед |Модет Мем * Мах]50 


|| Снеск-мв *] 


10 спеск-тз 


2020-03-13 
18:00 


17:52 


2020-03-07 


09:56 5 
выбрано направление дальнейшего развития проекта 


2020-03-05 


18:27 


добавлен стиль основного шрифта веб-страницы спе 


Рис. 4.17 
Созданные ветви «заголовок» и «содержимое» 


зипр!е зтае-раде ме зКе / тие 


Теа? спеск-п 


Кодт 


С781С9а25 изег. Мападег 1а9$: {тип 


сК-п- 9119706661 и5ег. ипрозег {а03: {лик 


на шкале времени 


Это позволило ему узнать идентификатор ветви, предназначенной для ра- 


боты над содержимым веб-страницы: 


2020-03-13 
18:00:58 [а99с3084089] 
Мападчег фадз: содержимое) 
17:52:44 [9359174457] 
Мападчег фадз: 
2020-03-07 === 

09:56:15 [с78аЕс9а25] *МЕВСЕ* *ВВАМСН* *СОВВ! 
ние дальнейшего развития проекта (изег: 


заголовок) 


ЕкипК) 


Стеаее пем БгапсП памеая "содержимое" 


Сгеаее пем БгапсВ папеа 


(изег: 


"заголовок" (п5ег: 


Е№МТ* выбрано направле- 


Мападег Тадз: 


—-- епёку 1111 (3) геасреа --- достигнут 


Чтобы переключиться на ветвь «содержимое» 


предел 


записей (3) 


В первый верстальщик вы- 


полнил команду выгрузки из репозитория в свой рабочий каталог моментально- 
го снимка, соответствующего первой точке сохранения интересующей его вет- 


ВИ: 
Еозз11 сБескойЕ аас3084089 


В ходе выполнения команда сообщила о выгрузке из репозитория двух 


файлов: 


1раех.с$5 
1паех.Веи1 
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Чтобы убедиться, что переключение на нужную ему ветвь произошло, 
верстальщик ввел команду: 


Еоз$11 ркапсь 


На экране отобразился список ветвей проекта, в котором активная ветвь 
отмечена символом *: 


Ехийк 
заголовок 
*х содержимое 


Таким образом, верстальщик |трозег1 подготовился к работе над содер- 
жимым веб-страницы. 

В это же время второй верстальщик посмотрел на шкалу времени проекта 
через веб-интерфейс и узнал, что идентификатор ветви «заголовок», которую 
ему предстоит развивать, равен 9369174467. Чтобы переключиться на эту ветвь, 
он ввёл команду: 


Еоз$11 срескойЕ 93591744Ъ7 


Но вместо переключения команда вывела сообщение об ошибке: 
поЕ Еоппа: 9369174467 не найдено: 93591744Ъ57 


Так произошло потому, что в локальном репозитории пользователя 
|прозег2 пока ещё отсутствуют сведения о том, что в проекте были созданы от- 
ветвления. Убедиться в этом можно с помощью команды Ю$$1 итепе -п 1: 
=== 2020-03-07 === 
09:56:15 [с78аЕс9а25] *МЕВСЕ* *СУОВВЕМТ* выбрано направление даль- 


нейшего развития проекта (изег: Мападег фадз: ЕкипкК) 
—-- епЕку 11116 (1) геасфеа --- 


Поскольку второй разработчик не изменял файлы в рабочем каталоге с 
момента последней синхронизации (в этом он убедился, введя команду Ю$$1 
спапдез и получив пустой ответ), он решил не выполнять полную синхрониза- 
цию, а только получить последние обновления из сетевого репозитория в ло- 
кальный, для чего выполнил команду: 


05511 ри11 


Команда сообщила об успешном получении сведений: 


Ру11 Еком БЕЕр://Тирозег2@Еоз$11.зегуег: 8081 / 
Воппа-Ег1рз: 2 АгЕ1Еас®ь5 зепе: 0 гесе1уеа: 2 
Рои11 аопе, зепёе: 891 гесел1уеЯ: 2337 1р: 192.168.56.101 


После того, как в локальный репозиторий попали имеющиеся в сетевом 
репозитории сведения о созданных менеджером ветвях, команда переключения 
на ветвь «заголовок» отработала в штатном режиме, сообщив о выгрузке из ре- 
позитория в рабочий каталог двух файлов: таех.с$$ и паех.Нт|. 

Чтобы убедиться в успешном переключении, верстальщик трозег2 ввёл 
команду 10$$й БгапсН и получил подтверждение: 
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ЕкойК 
*х заголовок 
содержимое 


Можно отметить, что создание новых ветвей и переключение на них 
участников проекта происходили не совсем легко из-за того, что требовалось 
узнавать идентификаторы точек сохранения для использования в командах. Но 
процесс значительно упрощается, если знать, что название ветви может исполь- 
зоваться в качестве синонима идентификатора последней точки сохранения, 
находящейся на ней. С учётом этого команды создания новых ветвей, ВыЫПоОЛНЯ- 
емые менеджером, могут быть записаны в виде: 


Ео5511 Ргапср пем заголовок &гиапк 
Еоз$511 Ргапср пеми содержимое Египк 


Поскольку 1типК — это название основной ветви разработки, то за основу 
создания новых ветвей будет использована последняя точка сохранения на ней, 
а это приведёт к тому же результату, что и при выполнении команд, указанных 
выше. Естественно, такой способ не сработает, если за основу новой ветви надо 
взять не последнюю, а более раннюю точку сохранения. 

Помимо этого, для переключения на новые ветви разработчики могут ис- 
пользовать такие команды: 

® [055$ спеской содержимое — выполняется первым верстальщиком для 
переключения на ветвь «содержимое»; 

® [0551 спескоц{ заголовок — выполняется вторым верстальщиком для пе- 
реключения на ветвь «заголовок». 

О том, почему возможна замена идентификаторов точек сохранения 
названиями ветвей, будет подробно рассказано в разделе, посвящённом ярлыкам 
и свойствам. 

А дальше работа над проектом пошла своим чередом. Руководство приня- 
ло решение использовать разрабатываемый в рамках проекта одностраничный 
веб-сайт в качестве портфолио и выложить его под свободной лицензией МП. 
Менеджер создал в своём рабочем каталоге файл ИСЕМЗЕ, заполнил его по об- 
разцу, размещённому на сайте И рз://тй-Псепзе.огд/, и загрузил в репозиторий, 
выполнив последовательность команд: 


Еоз311 ааа ТТСЕМЗЕ 
Еоз311 соми1Е -м "добавлен файл лицензии МТТ" 


Первый верстальщик в секции боду файла тдех.Нт! создал секцию тат, 
которой обозначил свой фронт работ, и начал разработку структуры блока 
зесйоп. Когда промежуточный результат его удовлетворил, он загрузил его в ре- 
позиторий с помощью команды: 


05511 соши16 -м "прототип блока содержимого - ма1п, зесЕ1оп" 
Второй верстальщик в уже существующей секции Веа4ег файла паех.Н т! 


создал блок Чм\ для названия организации и её девиза, после чего загрузил свою 
работу в репозиторий, выполнив команду: 


Ео$$11 соши1Е -м "блок названия организации и её девиза“ 
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После этого шкала времени проекта стала выглядеть, как показано на ри- 
сунке 4.18. 


© тре зпае-раде мебзйе: Тит Хх + в = 
< - Сы О незащищено | +ю551.егуег:8 081 /итейпе ж аз 
= Ноте Титейпе Рез Вгапспез 
Адуапсед |Модет Мем _*| Мах{50 |[Снеск-тз у | 


13 спеск-тз 


2020-03-13 
20:29 


20:21 


20:03 > 
добавлен файл лицензии МТ Геаг спеск-п: 307777себс изег Мападег!ад$: {тик 


18:00 


17:52 


2020-03-07 
09:56 


выбрано направление дальнейшего развития проекта 


спеск-п: с7891с9а25 изег. Мападег{адз: {тип 


Рис. 4.18 
Параллельное развитие трёх ветвей проекта 


4.3.3. Перемещение файлов в рабочем каталоге 


В это же время дизайнер закончил работу над графическими элементами 
веб-сайта и готов предоставить файлы изображений верстальщикам. Он — но- 
вичок в использовании репозитория и вынужден пройти те шаги, которые его 
коллеги уже давно выполнили (рис. 4.19). Посмотрим, что он делает, а заодно 
вспомним, как начинается работа с репозиторием. 


Сетевой репозиторий Локальный репозиторий Рабочий каталог 


ВЁр:/Иоз$1.зегуег:8081/ .Авзр\мебзНе-оса|40$5й 


Рис. 4.19 
Схема подготовки к работе с репозиторием проекта 


Сначала дизайнер пытается создать локальную копию сетевого репозито- 
рия на своём компьютере: 


Еоз$11 с1опе Пер: //9ез19лег@Еоз$11.зекуек/ ззриерз1е-1оса1.Ео0$$11 
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Он вводит пароль, подтверждает его сохранение, но команда завершается 
с ошибкой: 


раззмокга Еог аез1апехк: ******хх 

кететбет раззмока (У/п)? 

КВоппа-&:1рз: 2 АгЕ1ЕасЕ$ зепе: 0 геселуеа: 26 

Еггог: 10911 Еа11еА Ошибка: авторизация не выполнена 
Воппа-:1рз: 2 АгЕ1ЕасЕ$ зепе: 0 геселуеа: 26 

С1опе аопе, зепе: 567 геселуеа: 9750 1р: 192.168.56.101 


зегуег гебагпеЯ ап егког - с1опе арогее@ сервер вернул ошибку - 
клонирование прервано 


Раз ошибка произошла на этапе авторизации, программа установила связь 
с сервером, но не прошла проверку комбинация «имя — пароль». Дизайнер 
уверен, что пароль был введён правильно. Имя, кажется, тоже набрано верно, 
только строчными буквами. А в карточке учётной записи первая буква имени — 
прописная. Дизайнер попробовал выполнить команду, записав имя пользователя 
с большой буквы: 


Ео3$11 с1опе ВЕЕр://Рез1дрег@Ео$$11.зекуег/ ззриебз1ее-1оса1. {05511 


На этот раз команда завершилась без ошибок. Запомним на будущее, что 
регистр букв в имени пользователя Ро5$1 имеет значение: 


раззмога Еог Пез1апехк: ******жх 

кететбет раззмока (У/п)? 

Коппа-&:1рз: 2 АгЕ1ЕасЕ$ зепе: 0 геселуеа: 32 

С1опе аопе, зепе: 569 геселуеа: 10245 1р: 192.168.56.101 
Кери1141п49 героз16огу пефа-Чафка... 

100.0% сошр1ефе... 


Ехега Ае16а сопргкез$1оп... 

Уасиии1па ЕБе Чафбаразе... 

рго]есЕ-1а: 53е4е1445Ер2а7289ер1а337се1сЕ8с9а99Е7586 
зегуег-1а: 5052аЕр115ЕсЬ681603519Е41Е6с72516Ъ0аее2а 
аЯт1п-изег: Рез1апег (раззмока 1$ "а83р2Ь") 


Далее дизайнер создаёт рабочий каталог проекта, делает его текущим и 
открывает файл локального репозитория: 


пка1к мерз1ее 
са мерз1 Ее 
Ео$5$811 ореп ..\ззриебз1ее-1оса1.Ео0о$5$11 


Команда выполняется без ошибок и выводит на экран следующую ин- 
формацию: 


ЪТСЕМУЕ 
1раех.с$$ 


1паех.6 м1 


рго]есЕе-паме: $1тр1е °1п491е-раде мерз1е 


тероз1фоку: ../Рез1алег/меБз1ее/..\ззриерз1Ее-1оса1.Ео$$11 
1оса1-хкооф: ../Резлапех/мерз1Ее/ 
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сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 
рго]десе-соае: 53е4е1445Ер2а7289ер1а337се1сЕ8с9а99Е7Ъ86 


свескосе: 307777себс2а287927218Е08а5есЕс725еа89с01 2020-03-13 
20:03:51 ОТС 


рагепе: с78аЁЕс9а256с16с2е02692а0Еа6р2014071Ъае53 2020-03-07 
09:56:15 ОТС 


Тачз: ЕгипК 


соптепе: добавлен файл лицензии МТТ (изег: Мападег) 
свеск-1п$: 13 


Дизайнер считает, что на этом подготовительные мероприятия завершены. 
Теперь надо отправить в репозиторий два файла. Один файл называется 
пагокапа.0й и содержит фоновое изображение для заголовка. Другой файл назы- 
вается дето.]рд и будет использоваться в качестве иллюстрации информацион- 
ного блока. 

Дизайнер копирует файлы с графическими элементами в рабочий каталог 
проекта и добавляет их в список файлов, управляемых системой контроля вер- 
сий: 

Еоз$11 ааа аето.)ря БахЬкКапа.а1Е 


Ео55 сообщает об успешном выполнении операции: 


АРРЕР аето.)ра 
АРРЕР Багркапа. 1 Е 


После этого дизайнер загружает состояние рабочего каталога в репозито- 
рий: 
Ео$$11 соши16 -м "добавлены графические элементы для заголовка и 
информационных блоков" 


В ходе загрузки Ео5$Й предупреждает, что файлы аето.|рд и Вагокодпа.0# 
содержат двоичные данные, и запрашивает подтверждения на продолжение ра- 
боты. Дело в том, что система контроля версий наиболее эффективно работает с 
текстовыми файлами, она умеет их сравнивать и находить различающиеся 
строки. А по поводу двоичных файлов система контроля версий может говорить 
только в целом, являются ли они различными или совпадают полностью. Ди- 
зайнер подтверждает продолжение работы, вводя «у» с клавиатуры: 


Апбозурс: Вер: //Рез1длег@Ео$$11.зекхуегк:8081 / 

Воппа-Ег1рз: 1 АгЕ1Еас®5$ зепе: 0 гесе1уеа: 0 

Ра11 аопе, зепе: 430 гесетлуеа: 1280 1р: 192.168.56.101 

./аемо.)ру сопЕа1тз Б1паку Чафа. Озе --по-магп1паз ог Бе "Б1паку- 
а1ор" зебЕ1па во Ч915аЪ1е 115$ магкп1па. 

Сопи1е апубом (а=а11/у/М)? у 

./вагЬкКара.91Е сопфа1пз Ю1паку Чака. Озе --по-магп1паз ог ЕВе "Б1- 
паху-ч1оЪ" зееЕ1па фо Я91заб1е +115 магп1па. 


Сопм1е апубом (а=а11/у/М)? у 


Запись файлов в репозиторий продолжилась, в процессе было выведено 
ещё несколько информационных строк, не содержащих сообщений об ошибках: 
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Мм \ег51оп: 178еар2035929еса92ее4а1а8 97Юе63323988а997065а7953Е3е8абе4272абеа 
Апбозурс: Вер: //Рез1длехг@Ро$$11.зегуегк:8081 / 

Воппа-Ег1рз: 1 Аге1Еас®5 зепе: 3 гесе1уеа: 0 

бупс аопе, зепе: 15526 гесе1уеа: 1392 1р: 192.168.56.101 


Таким образом, дизайнер выполнил свою часть работы, и в игру снова 
вступает менеджер проекта. Он выполнил команду Ю3$Й ирдае для обновления 
содержимого своего рабочего каталога из репозитория. Поскольку по умолча- 
нию система Ео$51 находится в режиме автоматической синхронизации, то пе- 
ред выгрузкой в рабочий каталог моментального снимка из последней точки со- 
хранения, имеющейся в локальном репозитории, неявно выполнилась команда 
0551 ри|, что привело к получению в локальный репозиторий обновлений из се- 
тевого репозитория. Уже после этого произошла выгрузка файлов в рабочий ка- 
талог: 


Апбозупс: ВЕ: / /Мападег@Ео$$11.зегуег : 8081/ 

Воипа-Ег1рз: 2 АкЕ1Еасе5 зепЕ: 0 кеселуеа: 12 

Рои11 аопе, зепёе: 1251 гесе1уеа: 18810 1р: 192.168.56.101 

АРР аето.)ра 

АРР ВахЬКапа.а1Е 

ирааееа-Фо: 178еар2035929Ееса2ее4а1а897Ъеб3323988а99 2020-03-15 16:06:32 ОТС 
Тачз: ЕгипкК 


соппепе: добавлены графические элементы для заголовка и информаци- 
онных блоков (пи5ег: Пезфапег) 


спапаез: 2 Е11ез шоа1Е1еа. 


"Ео$$11 ипао" 15$ ауа11аб1е во ипао срапаез во ЕБе могК1па срескойе. 


Теперь в рабочем каталоге менеджера появились файлы аето.]рд и 
Багокопа.01, и он получил возможность ознакомиться с работой дизайнера. 
К самим графическим изображениям претензий не было. Однако с точки зрения 
структуры сайта было бы лучше разместить их в подкаталоге !тадез. Об этом 
менеджер и попросил дизайнера. 

Дизайнер создал в своём рабочем каталоге подкаталог итадез и переме- 
стил туда файлы с изображениями: 


пка1х 1мадез 
поуе аемо.)рда 1тадез\ 
поуе ПагЬкота.91Е 1тадез\ 


В результате этих действий система контроля версий потеряла два файла 
из списка файлов, которыми она управляет. Чтобы убедиться в этом, можно по- 
смотреть список произошедших в рабочем каталоге изменений с помощью ко- 
манды 10$$Й спапдез: 


МТ551ТМс аемо.)ра 
МТ551МСс ВахЬКапа.91Е 


В то же время система контроля версий обнаружила два бесконтрольных 
файла в рабочем каталоге, о чём рассказывает команда №0551] ехйгаз: 
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1падез/аемо.)ра 
1падез/ВагЬкалта.а1Е 


Устранить возникшее расхождение между системой учёта и реальным по- 
ложением дел можно, выполнив в Ео$$ сначала команду удаления старых фай- 
лов: 


05511 гм аето.)ряу БагюКапа.а1Е 


На экране появятся сообщения: 


РЕТЕТЕР аепо.)рч 
ГЕ Вагркапа. а1Е 


(2) 
т 
|= 

Е 


После этого можно выполнить команду на добавление в список системы 
контроля версий всех файлов из каталога !тадез: 


Еоз$11 ааа 1тадез 
Об успешном выполнении команды можно судить по сообщениям: 


АРРЕОР 1падез/аепо. ра 
АОРЕО 1падез/Вахркола. 91 Е 


Такого же эффекта можно было бы достичь, если после перемещения 
файлов в файловой системе выполнить команды перемещения их в системе 
контроля версий: 


Еоз311 шу аемо.)ра Бахькара.31Е 1тадез\ 


Выполнение команды сопровождается выводом информационных сооб- 
щений: 


ВЕМАМЕ Аето.)рду 1тадез/аепо.)ра 
ВЕМАМЕ рахькопа.а1Е 1падез/вахьКкора.ч1Е 


Только надо помнить, что команды системы контроля версий приводят к 
изменениям лишь её виртуальной файловой системы. В реальной файловой си- 
стеме файлы всё равно нужно перемещать с помощью команд операционной 
системы или файлового менеджера. Если переместить файлы только в системе 
контроля версий, а в файловой системе ничего не менять, то команда Ю$31 
спапдез сообщит о расхождении: 


МТ55ТМС 1тадез/аепо. ра 
МТ55ТМС 1мадез/вагЬкапа. 91 Е 


А после того, как файлы будут перемещены в обоих системах, контроля 
версий и файловой, команда 5$ свапоез сообщит лишь о произведенных из- 
менениях: 


ВЕМАМЕО 1тадез/аемо.)ра 
ВЕМАМЕР 1падез/вахькапа. 91 Е 


И всё же возможность перемещения файлов одной командой как в систе- 
ме контроля версий, так и в файловой системе существует. Чтобы выполнить 
такую операцию, надо воспользоваться опцией --йага: 


Ео5$11 шу --Вага аемо.)ра Вагокала.а1Е 1тадез\ 
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Команда сообщит о выполненных ею действиях: 


ВЕМАМЕ Аето.)рду 1тадез/аепо.)ра 


ВЕМАМЕ рагькопа.а1Е 1падез/вахькКора.ч1Е 
МОУЕР ЕТЬЕ ../Рез1дпег/мерз1ее/аето.)ра 
МО\ЕР_ЕТЬЕ ../Рез1дтег/мерз1ее/вахЬкопа.а1Е 


После выполнения просьбы менеджера дизайнер загрузил состояние ра- 
бочего каталога в репозиторий: 


Еоз$11 сошт1Е -м "файлы изображений перемещены в подкаталог 1тадез" 


Команда сообщила об успешном выполнении загрузки: 


Апбозурс: Вер: //Рез1длех@Ро$$11.зекхуегк: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепёе: 427 гесе1уеа: 1550 1р: 192.168.56.101 
Мем_Уег51оп: 
4еб430945143ра9еаес26 Е Р8сбес0Еасе75с9365е77008са5Е5аа1427Е218ЪаЕ 
Апбозурс: Вер: //Рез1длег@Ео$$11.зекхуег: 8081 / 


Воппа-Ег1рз: 1 Аге1Еас®5 зепе: 1 гесе1уеа: 0 
Зупс аопе, зепф: 2012 гесе1уеа: 1589 1р: 192.168.56.101 


4.3.4. Получение отдельных файлов из репозитория 


Первый верстальщик, узнав о готовности графических элементов веб- 
сайта, захотел сразу же подключить иллюстрацию к шаблону информационного 
блока. Он ввёл команду ю$$1 ирдае для получения обновлений в свой рабочий 
каталог, но файлы с картинками там не появились. Хотя, судя по информацион- 
ным сообщениям, команда выполнилась без ошибок: 


Апбозурс: Вер: //Ттрозег1@Ео$$11.зегуег:8081 / 

Воипа-Ег1рз: 2 АкЕ1Еасе5 зепе: 0 кеселуеа: 11 

Рои11 аопе, зепёе: 1215 гесе1уеа: 18481 1р: 192.168.56.101 

срескойе: Е8сс45794Е'72505984ее85869а8е6'70393е813а4 2020-03-13 20:21:18 ЧТС 
Сачз: содержимое 
сопмепе: прототип блока содержимого - ма1п, зесЕ1оп (изег: Тпрозег1) 


срапдез: Мопе. А1геаАу ир-бо-Яаа ее 


Почему так произошло и где находятся файлы с картинками? Посмотрим 
внимательно на строки, которые вывела на экран последняя команда. 

Первая строка сообщает о начале автоматической синхронизации локаль- 
ного репозитория с сетевым. Это происходит потому, что по умолчанию в си- 
стеме Е0о$51 действует режим амюзупс. По этой причине команда Ю3$1 ирдже, 
выполняющая обычно выгрузку мгновенного снимка, соответствующего теку- 
щей точке сохранения, из локального репозитория в рабочий каталог, перед 
этим провела синхронизацию репозиториев. 

Во второй строке сообщается о том, что в ходе синхронизации никаких 
сущностей (А|йас) не было отправлено в сетевой репозиторий (зеп: 0), а из 
сетевого репозитория было получено одиннадцать сущностей (гесемеа: 11). По 
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всей видимости, среди них есть и интересующие верстальцика файлы с изоб- 
ражениями. 

Третья строка сообщает о том, что получение информации из сетевого ре- 
позитория завершено (Ри! аопе), и отчитывается о деталях сетевого обмена: 
сколько байт было отправлено (зепЕ: 1215) и сколько было получено (гесемеа: 
18481). 

Интересно, что, несмотря на очевидный факт получения информации из 
сетевого репозитория, где уже точно есть графические файлы, в последней 
строке сообщается о том, что рабочий каталог находится в актуальном состоя- 
нии, и для него нет никаких изменений (спапдез: Мопе. Агеаду ир-ю-да!е). 

А вот теперь мы вплотную подошли к выяснению причины неполучения 
требуемых файлов. В строке сНеской: указан идентификатор точки сохранения, 
из которой мгновенный снимок выгружается в рабочий каталог, а в строке {а9$: 
указано название ветки репозитория, на которой эта точка сохранения находит- 
ся. Сравним полученные значения с теми, что были выведены дизайнеру, когда 
он делал выгрузку из репозитория в свой рабочий каталог: 


срескоце: 307777себс2а287927218Е08а5есЕс725еа89с01 2020-03-13 
ОО Те 

рагепе: с78аЁЕс9а256с16с2е02692а0Еа6р2014071Ъае53 2020-03-07 
09:56:15 ОТС 

Тачз: ЕгипК 


соптепе: добавлен файл лицензии МТТ (изег: Мападег) 


Дизайнер не выбирал ветвь репозитория, в которой ему предстояло рабо- 
тать, поэтому автоматически ему была назначена основная ветвь разработки — 
1гипк. В эту ветвь он и загрузил свои файлы с графическими элементами. Мене- 
джер, в отличие от верстальщиков, тоже не переключался с основной ветви раз- 
работки, поэтому у него не возникло проблем с получением файлов от дизайне- 
ра. А вот верстальщик ведёт работу в отдельной ветке «содержимое», для кото- 
рой в репозитории действительно нет никаких новостей. 

С причиной сложившейся ситуации разобрались. Но как же верстальщику 
всё-таки получить файл с иллюстрацией информационного блока? 

Первая мысль, которая пришла в голову верстальщику |трозе!1, была: 
«Надо создать ещё один рабочий каталог (Ро5$ позволяет использовать множе- 
ство рабочих каталогов к одному репозиторию), выгрузить в него моменталь- 
ный снимок из точки сохранения, которую создал дизайнер и которая содержит 
файлы с изображениями. После этого — переписать из него требуемый файл в 
основной рабочий каталог и продолжать работу». 

Такой вариант действительно имеет право на существование. Но нельзя 
ли всё сделать проще, без лишних сущностей в виде вспомогательных рабочих 
каталогов? Верстальщик не стал торопиться, а решил сначала осмотреться. 

Чтобы узнать, в моментальном снимке какой точки сохранения находится 
требуемый файл, он выполнил команду: 


Ео$$11 Е1ме11пе -Е с1 -т 2 
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Репозиторий Еозз используется для хранения всех сущностей, которые 
имеются в этой системе: файлов, сообщений форума, статей документации, за- 
явок на доработку. Чтобы отображались только точки сохранения, соответству- 
ющие операциям над моментальными снимками рабочих каталогов, в команде 
использован ключ -1 со значением с1. Ключ -п со значением 2 ограничивает вы- 
дачу двумя последними записями: 


=== 2020-03-15 === 18:46:48 [4е64309451] файлы изображений перемещены 
в подкаталог 1тадез (изег: Рез1апег Фадз: Екипк) 


16:06:32 [178еаЪ2035] добавлены графические элементы для заголовка 
и информационных блоков (изег: Пез1апек фадз: Егхиапк) 


—-- епЕеку 11116 (2) геасфеа --- 


Из описаний становится понятно, что интересующая точка сохранения 
имеет идентификатор 4е6 4309451. Верстальщик |трозег1 решил посмотреть, как 
выглядят файлы в мгновенном снимке, соответствующем этой точке сохране- 
ния, для чего воспользовался командой: 


Ео$$11 1$ -к 4е64309451 


Команда вывела список файлов, в котором присутствовали и загруженные 
в репозиторий дизайнером: 


1падез/аемо.)ра 
1падез/ВагЬкапта.а1Е 
1паех.с$$ 
1паех.6 м1 

ТТСЕМЗЕ 


Отлично, файл с иллюстрацией информационного блока обнаружен, это 
итадез/Чето.]рд. Осталось выгрузить его из мгновенного снимка в рабочий ката- 
лог. Для этого верстальщик ввёл команду: 


Ео5$11 ирЧафе 4е64309451 1тадез/аето.)рч 
Она выполнилась без ошибок и вывела на экран следующую информа- 
ЦИЮ: 


Аибозурс: Вер: //Ттрозег1@Ео$$11.зекуег: 8081 / 
Воппа-Ег1рз: 1 АгЕ1Еас®е5 зепе: 0 гесе1уеа: 0 
Рои11 аопе, зепе: 398 гесел1уеа: 1628 1р: 192.168.56.101 
АРР 1тадез/аемо.)ра ДОБАВЛЕН 1тадез/аето.)ра 


ирааееа-Фо: 4е6430945143ра9еаес26ЕЮ8сбес0Ёасе75с9365 2020-03-15 18:46:48 ОТС 
Тачз: ЕгипК 


соппепе: файлы изображений перемещены в подкаталог Шпадез (азег: Пез1апег) 


срапаез: 1 Е11е шоа1Е1еа. изменения: 1 файл модифицирован. 
"Ео5$11 ипао" 15$ ауа11аб1е Со ипао сВапдез во ЕВе мокклпа сВесКоч®. 


В результате выполнения последней команды в рабочем каталоге первого 
верстальщика был создан подкаталог !тадез, а в него записан файл Чдето.|рд. 
Цель достигнута, верстальщик может продолжать работу, используя изображе- 
ние с иллюстрацией для информационного блока. 
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Отметим, что в остальном состояние рабочег о каталога не изменилось. Он 
по-прежнему базируется на мгновенном снимке из точки сохранения, находя- 
щейся на ветке содержимое репозитория. Это подтверждается выдачей команды 
0$$Й чаи$: 
тероз1фогку: .../Тирозек1/меБзлее/. .\ззриерз1Ее-1оса1.Ео0$5$11 
1оса1-хгоо{: ../Ттрозек1/мез1Ее/ 
сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ео0$511 
срескойе: ЁЕ8сс45794Е72505984ее85869а8е6'70393е813а4 2020-03-13 20:21:18 ОТС 
рагепе: 99с308408924саасе8а39с2Е79Е512'70ъа444394 2020-03-13 18:00:58 9ТС 
Сачз: содержимое 
соптепе: прототип блока содержимого - ща1п, зесЕ1оп (изег: Тирозет1) 


И вообще, состояние репозитория, как сетевого, так и локального, не изме- 
нилось. Получение файла никак не отразилось на временной шкале (рис. 4.20). 


@ тре эпа-раде мебзйе: Ти. хо + 


< - С О не защищено | 1055.5егуег8081/тейпе ж о 


Зипр!е этае-раде ме $Ке / тете тоозеи — осы 


= Ноте Титетпе Ре$ Вгапспез 


Ауапсед |Модет Мем _*] Мах; [Свеск-4тв У] 


15 спеск-тз 


2020-03-15 


18:46 — в Е 
файлы изображений перемещены в подкаталог итадез 


Г еаГ спеск-п: 4еб 4309451 изег: Везюпег {ад$: {гипк 


добавлены графические элементы для заголовка и информационных блоков 
спеск-т: 178еа62035 изег: Оезюпег {адз: {гипк 


2020-03-13 
20:29 


Рис. 4.20 


Получение отдельных файлов из моментальных снимков в рабочий каталог 
не отражается в истории репозитория 
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Более того, над выгруженным из репозитория файлом отсутствует кон- 
троль со стороны системы контроля версий, о чём сообщает команда Ю$$1 
ех{газ: 


1падез/аемо.)ра 


Так может быть, стоит добавить этот файл в список контроля с помощью 
команды 10551 ада? Но зачем? Верстальщик |трозег1 не собирается его дораба- 
тывать, этим занимается дизайнер. Так пусть он и сопровождает его в основной 
ветке проекта — 1гипк. А первый верстальщик может продолжать работу над со- 
держимым веб-страницы, модифицируя НТМГ- и С$$-файлы в своей ветке 
«содержимое» и используя полученный файл !тадез/Чето.}рд в качестве вспо- 
могательного элемента. 

Позже, когда верстальщик выполнит свою работу, менеджер проекта вы- 
полнит слияние ветки «содержимое» с веткой гипК, и проект обретёт целост- 
ность. А пока верстальщику нет необходимости контролировать изменения в 
файле дето.рд. 

У читателя может ещё возникнуть вопрос, откуда верстальщик трозег1 
узнал о таких полезных ключах и параметрах команд Е0$$51, которые позволили 
ему получить требуемый файл без выгрузки мгновенного снимка в дополни- 
тельный рабочий каталог? Дело в том, что прозег1 владеет английским языком 
в пределах, достаточных для чтения технической документации, а справку по 
любой команде можно получить прямо от Ео$$1, например так: 


Ео$511 ре1р 15 
Или так: 
Ео$$511 пр4афе --Ве1р 
Перечень всех команд Роз можно вывести на экран с помощью команды: 


Ео$511 Ве1р 
4.3.5. Слияние ветвей 


Второй верстальщик проконсультировался у первого верстальщика отно- 
сительно способа получения файла с изображением из основной ветки репози- 
тория в свой рабочий каталог и повторил его действия. 

Сначала он запросил выгрузку изменений из репозитория в рабочий ката- 
лог, которая, в свою очередь, привела к синхронизации локального репозитория 
с сетевым: 


Ео$$11 прдафе 


Затем он узнал идентификатор точки сохранения, моментальный снимок 
которой содержит требуемый файл: 


Еоз$11 Е1ме11пе -Е с1 -т 2 


Потом посмотрел, какие файлы имеются в моментальном снимке: 
Еоз$11 1$ -г 4е64309451 
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И, наконец, выгрузил из моментального снимка, хранящегося в репозито- 
рии, в свой рабочий каталог файл итадез/нагЬКоапча.ои: 


Еоз$11 ираЕе 4е64309451 1тадез/вахькара. 1 


После этого оба верстальщика продолжили работу над своими задачами. 
Они продвигались к цели небольшими шагами, завершая каждый этап создани- 
ем точки сохранения в репозитории с помощью команды 10$$1 сотти. Через не- 
продолжительное время верстальщики пришли к выводу, что готовы предоста- 
вить результаты работы в основную ветку проекта (рис. 4.21 и 4.22). 


@ 5тьое эпае-раде ммебзИе х + т ы - 
< С О айл | О:Моз5ИАтрозег1 Амеб5Недпаех. Бат! х © 
Сотрапу Зес#оп 1 ЗесНоп 2 ЗесНоп 3 ЗесНоп 4 


Гогет 'рзит 4о|ог $й атё{, сопзес&иг 
аЧрузста ей, зед до еизтоа {етрог 
шпааиупЕ щ 1абоге е{ до]оге тадпа 
айдиа. \{ епит ад плит уетат, 915 
поз{ги4 ехегсцаноп иЙатсо |абоп$ п! 
Ш айашр ех еа соттодо сопзедиа{. 
0$ аще гиге дог п гергепепаей п 
уоирае уей ез5е сШит адооге еи 
да пуЙа рапашг Ехсереиг зи 
оссаеса{ сир4аа{ поп ргоеги, зип п 
сура аш отаа дезегип{ по! апит 19 
ез{ (абогит. 


Гогет 1рзит до1ог $й ате{, сопзебеиг 
адризста ей, зе до ешзто4 {етрог 
исаиупЕ Ш 1абоге е{ доюге тадпа 
айдиа. (4 епит ад тит уетат, 45 
по${гид ехегсцайоп иЙатсо |абоп$ п! 
Ш а!ашр ех еа сотто4до сопзедиае 
Ои$ аще тиге доог т гергепепдет т 
уоирае умей еззе сит доюге еиц 
Ка пийа рапашг Ехсереиг зи 
оссаеса{ сир4а{а{ поп ргодеп, зип т 
сШра аш отса дезегип{ тойй апит 4 
ез{ 1абогит. 


Рис. 4.21 


Результат работы первого верстальщика — 
содержимое веб-странички 
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@ тре зпае-раде мебзие х + 


< > С Фо | Оо Лтроег2/ззрмебзНеЛпаех. пати 
Сотрапу Зесёоп1 — Зесцоп 2 Зес#оп 3 Зесйоп 4 


Гогет 
1рзит аоюг 
$Й ате{ 


Рис. 4.22 
Результат работы второго верстальщика — заголовок веб-странички 


Непосредственно перед слиянием шкала времени проекта выглядит так, 
как показано на рисунке 4.23. 


@ тре этае-раде мебзйе: Ти х + 


< -> С О не защищено | 10551.5егуег8081Айтейпе 


Зипр!е этае-раде мезКе / теже 


Ноте Титейпе [Иез Вгапспез 


Модет \Мем _] Мах]50 Спеск-ив_* 


28 спеск-тз 


2020-03-17 
14:44 


добавлено фоновое изображение для заголовков информационных блоков 
1 еаЁ спеск-п: 267246026 изег. езюпег {а05: гипК 


Рис. 4.23 
Шкала времени перед слиянием ветвей 
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Слиянием ветвей менеджер решил заняться самостоятельно. Прежде все- 
го он, уже по привычке, выполнил команду выгрузки последних обновлений из 
репозитория в свой рабочий каталог: 


Ео$511 прдафе 


В результае на его рабочем каталоге отразилось перемещение дизайнером 
файлов изображений в созданный для них подкаталог !тадез, а также был полу- 
чен ещё один файл Н26Кдпа.9й, содержащий фоновое изображение для заголов- 
ков информационных блоков: 


Апбозупс: ВЕЕр: / /Мападег@Ео$$11.зегуег : 8081/ 
Воппа-6тг1рз: 2 АгЕ1Еас®5 зепе: 0 гесе1уеа: 29 

Ри11 аопе, зепёе: 1906 гесе1уеа: 8689 1р: 192.168.56.101 
ВЕМОУЕ аепо.)рач 

ЕМОУЕ Багркапа.ч1Е 


В 
АБР 1падез/аемо.)ра 

АБР 1тадез/26капа.а1Е 
АБР 1тадез/вагЬкапа. ч1Е 


ирааЕеа-Фо: 2672сас02Ъ453Е65Бае'76еа9ъаа7559895Е50а92 2020-03-17 09:41:18 ОТС 
Тачз: ЕгипкК 


соппепе: добавлено фоновое изображение для заголовков информацион- 
ных блоков (азег: Без1апег) 


срапдез: 5 Е11ез шоа1Е1еа. 
"Ео$$11 ипао" 15$ ауа11аб1е во ипао сВапаез во ЕБе могК1па срескойе. 


Исходные тексты, находящиеся в рабочем каталоге менеджера, формиру- 
ют очень невзрачную веб-страничку (рис. 4.24): 


© этреЕ зпае-раде меб зйе х - 5 Е х 
< СФ ал | ОМо55ИМападег/АмебйеДпаех. Вт! * [>] 
Сотрапу ЗесНоп 1 ЗесНоп 2 ЗесНоп 3 Зес#воп 4 
Рис. 4.24 


Веб-страничка по исходным текстам основной ветки репозитория 
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Менеджер решил напомнить себе, какие ветви проекта развиваются сей- 
час в репозитории: 


Еоз$11 ркапсь 
Команда сообщила О трёх активных ветвях, звёздочка отмечала, что рабо- 
ЧИЙ каталог менеджера отражает состояние [ее (6:35 (71 ветви репозитория {ийК: 


* Екарк 
заголовок 
содержимое 


Начать слияние менеджер решил с заголовка. Чтобы узнать идентифика- 
тор последней точки сохранения ветви «заголовок», менеджер ввёл команду: 


Еоз$11 ЮкапсВ 1пЁо "заголовок" 


Из ответа команды выяснилось, что искомый идентификатор равен 
4аес8726е462614: 


заголовок: ореп аз оЕЁ 2020-03-17 09:33:13 оп 4аес8726е4Ъ2р1Е4 


Для того, чтобы влить ветвь «заголовок» в точку сохранения, которой со- 
ответствует рабочий каталог, менеджер выполнил команду: 


Еоз$11 шегае 4аес8726е421Е4 


Команда выполнилась без проблем, сообщив о том, что в ходе её выпол- 
нения были обновлены два файла: 


Апбозупс: ВЕЪр: / /Марадег@Ео$5$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еас®е5 зепе: 0 гесе1уеа: 0 

Ро11 аопе, зепе: 395 гесел1уеа: 2678 1р: 192.168.56.101 

ОРРАТЕ 1паех.с$$ 

ОРРАТЕ 1паех.6 м1 

"Ео$$11 ипао" 15$ ауа11аб1е во ипао срВапаез во ЕБе могК1па срескойе. 
Для уточнения состояния рабочего каталога менеджер выполнил команду: 


Еозз11 збабаз 


Информация, выданная командой, В подробностях описывает выполнен- 
ное вливание ветви «заголовок» в основную ветвь репозитория. 


тероз1огу: .../Мападек/мерз1ее/.. \ззриеБз1ее-1оса1.ЁЕо$$11 
1оса1-коо®: .../Мападег/мебз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/_Ёо$511 

срескойе: 2672сас025453Е65рае76е99ъаа7559895Е50а92 2020-03-17 09:41:18 ОТС 
рагепе: 4е6430945143Ъа9еаес26Е68сбес0Еасе75с9365 2020-03-15 18:46:48 ОТС 
Тачз: ЕгипК 

сопмепе: добавлено фоновое изображение для заголовков информацион- 
ных блоков (азег: ОБез1оапег) 

ОРРАТЕР_ ВУ _МЕВСЕ 1паех.с55 

ОРРАТЕР_ВУ_МЕВСЕ 1паех.В®и1 

МЕВСЕР МТТН 
4аес8726е45251=435{е2=61401са2а5ба22се71500470767ю6сс6954а4с29ар 
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е эитр!е эпо!е-раде меб йе х + 
= СФ хам | О:Мозя/Мападег/меБЙепаех. ит! х © 
Сотрапу Зес#оп 1 Зесйоп 2 Зес#оп 3 Зес#оп 4 
Гогет 
рзит аоюог 
$ ате{ 


Рис. 4.25 
Веб-страничка после получения заголовка 


Слияние произошло бесконфликтно. Система Ео$$1 самостоятельно спра- 
вилась с анализом тех незначительных изменений, которые внёс в исходные 
файлы проекта верстальщик |трозег2. Сам факт слияния пока что никак не от- 
разился на репозитории, он произошёл только в рабочем каталоге менеджера. 
Если бы результат слияния менеджера не устроил, он мог бы выполнить коман- 
ду Ю3$Й ипдо, и рабочий каталог был бы возвращён в предыдущее состояние. 
Однако, ознакомившись с результатом (рис. 4.25), он решил зафиксировать его в 
репозитории с помощью команды: 


Ео$5$11 соми1Е -м "принят заголовок веб-страницы" 


Как обычно, команда отчиталась о резульгате своей работы: 


Апбозупс: ВЕЕр: / /Марадег@Ео$$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еасе5 зепе: 0 гесе1уеа: 0 

Ра11 аопе, зепе: 430 гесетлуеа: 2677 1р: 192.168.56.101 

Мем Уег51оп: 
5бе4а0с8Е6бсс7ае64аЕ1с2а?есЕ2Раа4с470Е2084882157еа2359022е749762е 
Апбозупс: ВЕ: / /Марадег@Ео$5$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еасе5 зепе: 1 гесе1уеа: 0 

Зупс аопе, зепе: 3084 гесе1уеа: 2716 1р: 192.168.56.101 


После загрузки моментального снимка рабочего каталога менеджера в ре- 
позиторий факт слияния ветви «заголовок» с основной линией разработки 
нашёл отражение в репозитории, и шкала времени проекта приобрела вид, по- 
казанный на рисунке 4.26. 
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© тре эпае-раде мебзйе: Тито Х + 


- С О Ннезащищено | 1055Й.5егуег:8081 Аите!те х @ 


тре эта!е-раде ме$Ке / ттешь ‚ВИВЕ УИ 


= Ноте Титейпе Ре5 Вгапспез 
Афуапсед |Модет \Мем *| Мах150 Среск-тз т 
29 спеск-т5 
2020-03-17 
17:47 
принят заголовок веб-страницы 1 ва! спеск-п: 56е4а0с816 изег: Мападег{адз: пипк 
14:44 
подключено фоновое изображение к заголовкам информационных блоков 
ГеаГ спеск-п; 1с603901а2 изег. ипрозег! а9$: содержимое 
09:41 


добавлено фоновое изображение для заголовков информационных блоков 
спеск-п: 2672095026 изег Оезюпег (ад: 1 


ы Розьинниныы" 77-7 


Рис. 4.26 
Шкала времени после получения заголовка 


Менеджер ещё раз открыл в веб-браузере файл таех.Н т! из своего рабоче- 
го каталога и внимательно рассмотрел заголовок веб-страницы. В целом всё вы- 
глядело неплохо, но гиперссылки, образующие горизонтальное меню, со своим 
ярким синим цветом и традиционным подчёркиванием выглядели слишком 
аляповато. 

Поскольку рабочий день только что закончился и верстальщика уже не 
было на рабочем месте, менеджер самостоятельно подправил стили в файле 
пдех.с$$. Результат работы он записал в репозиторий командой: 


Ео5$11 соши1е -м "исправлен шрифт горизонтального меню в заголовке 
странички" 


Теперь пришло время заняться содержимым веб-странички. Менеджер 
запросил информацию о ветке репозитория, которую развивал верстальщик 
|прозег1, командой: 


Ео$5$11 Бкапср 1пЕо "содержимое" 
Эта команда вывела на экран строку: 
содержимое: ореп аз оЕЁ 2020-03-17 14:44:46 оп Ес6Ь890Еа2454143 


Из полученной информации стало понятно, что идентификатор последней 
точки сохранения на ветви «содержимое» равен ©66890{а2454143. Для слияния 
ветви «содержимое» с основной ветвью проекта менеджер ввёл команду: 


Ео$з511 шегае Ес6Ю890Еа2454143 
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В ходе слияния система Ео$51] не смогла автоматически наложить измене- 
ния из вливаемой ветви на файл тдех.с$$ в рабочем каталоге менеджера и со- 
общила о конфликте: 


Апбозупс: ВЕ: / /Марадег@Ео$5$11.зегуег:8081/ 

Воппа-Ег1рз: 1 Аге1Еас®5 зепе: 0 гесе1уеа: 0 

Рои11 аопе, зепёе: 398 гесе1уеЯ: 2793 1р: 192.168.56.101 

МЕВСЕ 1п49ех.с$5 СЛИЯНИЕ 1паех.с55 

ххжххх 1 шегае сопЕ11се5$ 1п 1п4ех.с$$ 1 конфликт слияния в 1п4ех.с5$5 
МЕВСЕ 1паех.ВЕп1 СЛИЯНИЕ 1паех.6 м1 
МАВМТМС: 1 шегде сопЕ11сез ПРЕДУПРЕЖДЕНИЕ: 1 конфликт слияния 
"Ео$$11 ипао" 1$ ауа11аб1е во ипао срапаез во ЕБе могК1па среской®. 


Менеджер уже второй раз на этом проекте столкнулся с конфликтом слия- 
ния, поэтому не стал паниковать, тем более что выполненная операция пока что 
произвела изменения только в его рабочем каталоге, а не в репозитории, и при 
необходимости её можно отменить командой 10351 ипдо. Он решил ознакомиться 
с возникшей ситуацией более подробно и в первую очередь выполнил команду: 


Еозз11 збабаз 


Как обычно, команда вывела на экран несколько строк с информацией: 


тероз1огу: .../Мападек/мерз1ее/.. \ззриеБз1ее-1оса1.ЁЕоз$11 
1оса1-кооб: ../Марадег/мебз1ее/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 

среской{: а295807се2Е2525Е491069арсЗаеЕЕ5а91Зе3 6аа 2020-03-18 06:42:20 ОТС 
рагепе: 56е4а0с8Е6сс7ае64аЕ1с2а2есЕ2Еа94с470Е208 2020-03-17 17:47:37 ОТС 
Сад: ЕкипкК 
сопмепе: исправлен шрифт горизонтального меню в заголовке странич- 
ки (изег: Мападехг) 

СОМЕЬТСТ 1паех.с$$ 

ЕОТТЕО 1раех.6ет1 

МЕВБСЕР МТТН 
Ес65890Еа24541434986За3ЕаЕ3е9+5а3тее0е5сасбабс821с132с4аа994Ееь5 


Последняя строка говорит о том, что действие, которое было выполнено 
над рабочим каталогом, — это слияние с ветвью {65890а... Предпоследняя 
строка информирует, что в результате слияния файл таех.пит! был изменён. 
А строка, ей предшествующая, сообщает о том, что при попытке наложения из- 
менений на файл таех.с$$ были обнаружены перекрывающиеся участки, и это 
вылилось в конфликт и необходимость ручного вмешательства. 

Как всегда, при конфликте слияния система Е0$$1 создала в рабочем ката- 
логе три варианта проблемного файла: 

® паех.сз$-базете — файл из моментального снимка репозитория, кото- 
рый соответствует той точке сохранения, в которой было выполнено ответвле- 
ние (т. е. последней общей точке сохранения для обеих ветвей, участвующих в 
слиянии); 

® паех.сз$-тегде — файл из вливаемой ветви репозитория; 
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® пдех.сз$-опдта! — резервная копия файла паех.сз$ из рабочего каталога 
на момент, предшествующий слиянию. 


Листинг. таех.с55-фазейпе 


* {пага1п: 0; рааа1та: 0} 
роау {ЕопЕ: погма1 погма1 погма1 100% запз-зег1 ЕЁ} 
реаает {расКагоппа: агау; Баскагопра: 11пеаг-дгаЧ1ет® (о Фор, #000, #РЕЕ) } 


Беаае 


па\у {Еопе-мезаве: ро1а; Еопе-аесога®1оп: ипаегсоге} 


Беааег пау 91 11 а:Боуег {ЕехЕ-аесога®1от: ппаек11пе} 


РеаЧег пау 11 
р1ау: 1п11пе} 


11 {пага1п-1еЕе: 2ещ; 11$з6-з6у1е-буре: попе; @15$ 


Веа4ет пау 11 11:Е1:и56-ср11А {пагд1п-г1аре: беп} 


Листинг. таех.с55-тетее 


* {пага1п: 0; рааа1та: 0} 
роау {ЕопЕ: погма1 погма1 погща1Т 100% запз-зег1 ЕЁ} 


Беааег {раскагоч 
Беааек 

Беааег пау 11 

Беааег пау 11 
р1ау: 1п11пе} 

Беааег пау 11 

па1п {пах-м1ае 


р: адгау; БаскагойпЯ: 11пеаг-дгаЯ1ер® (Фо бор, #000, #ЕРЕР) } 


па\у {Еопе-мелзаве: Бо1а; Еопе-аесога®1оп: ипаегсоге} 
11 а:Похег {сехе-аесога®1оп: ип4ег11пе} 


11 {пага1п-1еЕе: 2ещ; 11$56-з6у1е-буре: попе; @1$ 


11: Е1кзе-ср11а {пага1п-хк1аре: бещ} 
ВБ: 1000рх; мага1п: аибо; рааа1па: 4ех 2%; Баск- 


ахоппа-со1ог: 


зесЕ1оп {тага1п-бор: 2ех; ра@а1пч: 1ех 1ещ; ЕехЕ-а119п: )]и5%1Еу} 


зесЕ1оп {тага1п-1еЕЕ: 5%; мага1п-г1аре: 5%} 
зесЕ1оп {м1лп-Бе1аье: 200рх; БаскКакоппа: имр1е} 


зесЕ1оп Беааех 
зесЕ1оп Беааек 


{раскакоцпа: попе} 
2 {раскагоира-1таде: пх1 (1тадез/в25кора.а1Е); 


Баскакоцпа-ро$1Е1оп: БоЕЕош; раскКагоппа-гереа®: гереа®-х} 


зесЕ1оп 1м9 {пага1п-роЕеом: 1ех} 
зесЕ1оп : пЕВ-сЬ11а (о4а) ПБеааег {ЕехЕ-а11ап: 1еЕф; Е1оа®: 1еЕ%} 


зесЕ1оп : пЕВ-сЬ11а 
зесЕ1оп : пЕВ-сЬ11 
зесЕ1оп : пЕВ-сЬ11 
зесЕ1оп : пЕВ-сЬ11 
зесЕ1оп : пЕВ-сЬ11 


(оаа) 1ма {Е1оа®: х1арЕ; пага1п-1еЕ®: 1.4ещ} 
(оаа) а1у {с1еаг: 1еЕ%} 

(еуеп) Реааег {Еех®е-а119п: г1аВе; Е1оа®: г1908} 
( 

( 


уеп) 1ма {Е1Тоае: 1еЕе; пагоа1п-г1аре: 1.4ем} 
уеп) А1у {с1еаг: г1а0е} 


е 
е 


зесЕ1оп Бг {с1еаг: Боёр; Богаег: 0Орх $011а} 


Листинг. таех.с55-опета! 


* {пага1п: 0; рааа1та: 0} 
роау {ЕопЕ: погма1 погма1 погща1 100% запз-зег1 ЕЁ} 


реаЧет {раскКагоч 


еааехг пау\у 11 
еа@ехг пау\у 11 
реааег паху \1 11 


Беааег {пах-м1аЪ: 


Кеа@етг пау {ЁЕоп®е-мезаВе: Бо14а; ЕопЕ-аесогха®1опт: попе 
11 а {со1ок: #777; ЕехЕ-Чаесогкае1оп: попе} 
11 а:Роуег {кехе-аесогха®1оп: апаех11пе 


еааег пау 11 


11: Е1у56-ср11А {пага1п-х190е: бет} 
Кеааег Ч1\у {Безайе: 160рх; мага1п-бор: 2ех; рааа1па-1еЕЕ: 20%} 
Беайехг а1у {ЕехЕ-а119т: 1еЕЕ; Еопё: похмаТ погма1Т ро1а 1.8ем зап$-5ег1 Е} 


1000рх; паха1п: айео; рада: 4ех 2%; фехЕ-а11от: сепеег} 
ра: агау; БаскагойпЯ: 11пеаг-дга@а1ер® (Фо бор, #000, #ЕРЕР) } 


{паха1п-1еЕе: 2ещ; 115%-з6у1е-буре: попе; а1$р1ау: 1111пе} 
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Беа4ехг А1у {Баскагопра-1таде: их1 (1тадчез/вахЬкапа.а1Е); 
Баскагоипа-ро$1Е1оп: 80% сепфег; расКагоцпа-гереа®е: по-гереа*} 


Листинг. т4ех.с$5 непосредственно после слияния 


* {пага1ш: 0; рааа1та: 0} 

роау {ЕопЕ: погма1 погма1 погща1 100% запз-зег1 ЕЁ} 

еайег {пах-м1аЕВ: 1000рх; махго1п: айбо; рааа1та: 4ех 2%; ехЕ-а1190: сепеег} 

Беадет {раскагойп@: агау; Баскагоппа: 11пеаг-дгаЯ1епт® ($о бор, #000, #ЕЕР) } 

пеа@етг пау {ЁЕоп®-мезаВе: Бо1а; ЕопЕ-аесога®1опт: попе} 

реаЧехг па\у и1 11 а {со1ог: #777; ЕехЕ-ЧесогаЕ1опт: попе} 

пеаЧаег пау\у и1 11 а:Поуег {сехЕе-аесога®1оп: ипаег11пе} 

пеабетг паху 11 11 {тага1п-1еЕе: 2еш; 11565-56 у1е-6уре: попе; 4915$р1ау: 111 ше} 

пеааег па\у и1 11:Е1:56-ср11А {пага1п-х190е: бет} 

<<<<<<< ВЕСТМ МЕВСЕ СОМЕЪТСТ: 1оса1 сору зБомп ЁЕ1кзЕ <<<<<<<<<<<<< 

Кеа@ег А1у {Бе1таВе: 160рх; мага1п-бор: 2ех; рааа1па-1еЕЕ: 20%} 

пеаЧег @1\ {ЕехЕ-а11дп: 1еЕё; Еопе: погма1 погма1 Бо1а 1.8ем запз- 

зег1Ё} 

Беа@ег Я1\у {Баскакоипа-1таде: иг1 (1тадез/вакькопа.а1Е); 
расКкакоцпа-ро$з1Е1оп: 80% сепЕег; Баскагоцпа-гереа®: по-гереа®} 

= == СОММОМ АМСЕЗТОВ сопЕепЕ Ео11ои5 

======= МЕВСЕР ТМ сопбепе Ео11о0м5 

па1п {пах-и1аер: 1000рх; пага1п: аиф®о; рааа1та: 4ех 2%; Баск- 

агоипа-со1ок: З#ЕЕЕ 

зесЕ1оп {тага1п-бор: 2ех; рааа1па: 1ех 1ем; СехЕ-а1191п: ]а5Е1ЕуУ} 

зесЕ1оп {тага1п-1еЕЕЁ: 5%; шага1п-г1аре: 5%} 

зесЕ1оп {м1лп-Бе1аье: 200рх; БаскКагкоппа: мр1е} 

зесЕ1оп БеаЧег {расКагопп@а: попе} 

зесЕ1оп Беа4ехг №2 {раскагоипа-1таде: п:1 (1тадез/в25кКора.а1Е); 


раскакоцпа-ро$1Е1оп: БоЕЕош; раскКагоппа-гереа®: гереа®-х} 
зесЕ1оп 19 {пага1п-роЕеом: 1ех} 
зесЕ1оп : пЕВ-сЬ11а (оаа) ВБеааег {ЕехЕ-а11ап: 1еЕ®; Е1оа®: 1еЕ%} 
зесЕ1оп : пеВ-сЬ11а (оаа) 1ма {Е1оа®: г1арЕ; тага1п-1еЕ Е: 1.4ещ} 
зесЕ1оп : пЕВ-сЬ11а (оаа) а1у {с1еаг: 1еЕ{} 
зесЕ1оп : пе В-сЬ11а (еуеп) Беа4ек {$ехЕ-а119п: г1аВе; Е1оа®: г190%} 
зесЕ1оп : пЕП-сЬ11а (еуеп) 1мд {Е1оа®: 1еЕЁб; пага1п-г1аре: 1.4ет} 
зесе1оп : пЕВ-ср11а (еуеп) А1у {с1еаг: г190®} 
зесЕ1оп Вх {с1еаг: БРоЕй; Рогаег: Орх 50114} 
>>>>>>> ЕМР МЕВСЕ СОМЕБТСТ >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 


При выполнении слияния двух вариантов файла таех.сз$ (существующего 
и вливаемого) система Еоз$ определила часть этого файла, общую для обоих 
вариантов, и отделила её от остальной части строкой < ВЕСИМ МЕАСЕ СОМЕНСТ: 
оса! сору зПо\мп #31 < (НАЧАЛО КОНФЛИКТА СЛИЯНИЯ: сначала показана 
локальная копия). После неё система Ео$$Й разместила строки, имеющиеся в 
варианте файла рабочего каталога, но отсутствующие во вливаемом варианте, и 
завершила этот блок строкой = СОММОМ АМСЕЗТОВ сощеп{ Юомз = (далее идёт 
содержимое ОБЩЕГО ПРЕДКА). 

По идее, после этой строки должен идти текст, который присутствовал в 
файле до создания ветви «содержимое», но потом был изменён как в основной 
ветви, так и в её ответвлении. В данном случае такой текст отсутствует, поэтому 
соответствующий ему блок пуст. 
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Далее, после строки = МЕАСЕФ 1М сощеп{ ЮНом$ = (содержимое ВЛИВА- 
ЕМОГО ФАЙЛА), следует текст, имеющийся в варианте файла таех.сзз из вет- 
ви «содержимое» и перекрывающий соответствующий текст в варианте файла 
рабочего каталога. Строка > ЕМО МЕВСЕ СОМЕЦСТ > (КОНЕЦ КОНФЛИКТА 
СЛИЯНИЯ) завершает блок различающихся участков файла таех.сз$. 

В данном примере решение конфликта не составляет трудности. Посколь- 
ку с момента ответвления оба верстальщика записывали в файл таех.с$$ прави- 
ла стилевого оформления для той части веб-странички, над которой они работа- 
ли, то оба конфликтующих с точки зрения Роз блока должны быть сохранены 
в результирующем файле таех.сз$. 

Поэтому менеджер просто удалил из файла таех.с$$ служебные строки, 
вставленные системой Е0551 для разделения блоков, и открыл файл таех.Пт в 
веб-браузере, чтобы убедиться в правильности своих предположений (рис. 4.27). 


= х 


@ трое эпае-раде мебзйе х м 
— С Файл | О:Мозя/Мападег/ме6йеЛипдех. Вт! * © 
Сотрапу Зес#оп 1 Зесвоп 2 ЗесНоп 3 ЗесйНоп 4 
Когет 
{рзит аоюг 
$Н ате{ 


Гогет 1рзит 9400г $й атеё, сопзееиг 
ар1зста еШ, зе 4о ешзтод 1етрог 
паиупЕ Ш абоге е{ дооге тадпа айиа 
(И епт а@ ттт уепат, 94$ позгиа 
ехегсйайоп иЙатсо 1абопз пи!з! щ айашр ех 
еа соттойо сопзедиа!. Ош аще 1гиге дог 
п гергерепдегй т уоирае уей еззе сит 
дооге еи гида! пиЙа рапа!иг. Ехсер{еиг зи 
оссаеса{ сирЧаа{ поп ргодет{, зип п сшра 
ди ойса дезегип{ пойй апит 14 ез{ 1абогит 


ЗесНоп 1 


Гогет 1рзит дог $й ате сопзесеиг 
ачр/зста ей, зе9 40 ешзто@ \етрог м 


Рис. 4.27 
Веб-страница после вливания ветви «содержимое» 


Это был именно тот результат, что и требовался. Перед записью момен- 
тального снимка рабочего каталога в репозиторий менеджер ещё раз проверил 
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состояние с помощью команды 10$$Й спапдез — файл паех.сз$ больше не был 
конфликтующим, а стал исправленным, как и файл паех.Нт!: 


ЕОТТЕО 1паех.с$$ 

ЕОТТЕО 1раех.6ет1 

ЮКСЕР ИТТН 
Ес6Ъ890Еа24541434986За3ЕаЕ3е9+5а3тее0е5сасбабс821с132с4аа994Ееъ5 


Менеджер создал точку сохранения в репозитории командой: 


Ео$$11 соши16 -м "принято содержимое веб-страницы" 


Из-за того, что он в своё время не выполнил дополнительную настройку 
Ео5$, ему пришлось давать разрешения на запись в репозиторий текстовых 
файлов, у которых в качестве символов перевода строк используются двухбай- 
товые комбинации СВ/СЕ: 


Апбозупс: ВЕЪр: / /Марадег@Ео35$11.зегуег:8081/ 

Воппа-Етг1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Ра11 аопе, зепе: 432 геселуеа: 2793 1р: 192.168.56.101 
./1раех.сз$ сопфа1пз СВ/ТЕ 11пе епа1паз. Изе --по-магп1па$ ог Ве 
"сЕ1Е-а1ор" зеЕЕ1па о Я91заЪ1е 61$ магкп1па. 

Сопм1Е апубом (а=а11/с=сопуеке/у/М)? у 
./лраех.6т1 сопба1пз СВ/ЪЕ 11пе еп@а1пд$. Озе --по-магп1паз ог Ве 
"сЕ1Е-а1ор" зеЕЕ1па о Я91заЪ1е 61$ магкп1па. 


Сопм1е апубом (а=а11/с=сопуекЕ/у/М)? у 


Мем _Уегз1оп: 
921е92е400с3Е2Ъ56Е1 553а9 Е ЕБ44с2е452959а19Есса5Ъа2са2728а817ее2Еаь 


Апбозурс: ВЕЪр: / /Марадег@Ео$5$11.зегуег:8081/ 


Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 3 гесе1уеа: 0 
бупс аопе, зепе: 4302 гесе1уеа: 2905 1р: 192.168.56.101 


После вливания ветви «содержимое» в основную ветвь репозитория шка- 
ла времени проекта приобрела вид, показанный на рисунке 4.28. 

Казалось бы, на этом можно и остановиться. Но если выполнить команду 
0551 ехгаз, то она выведет на экран список забытых файлов, автоматически со- 
зданных Ео$$1 в помощь для решения конфликта слияния: 


1паех.сз$-разе11пе 
1паех.сз5-мегае 
1паех.с$$-ох191па1 


На этот раз файлы не пригодились, и их можно удалить из рабочего ката- 
лога командой 4е! *-* (в \Мтдо\з) или ит *-* (в ОШХ и Глпих). 
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@® тре эпае-раде мебзйе: Ти" х + 


< - С О не защищено | 1055й.5егуег-8081 Аитейте и © 


этр!е з$тае-раде меь$Ке / теле = малы — подо 


= Ноте Титете Рез Вгапсвез Озегз 


Адуапсед |Модет \Мем т] Мах[50 _ ][Свескатв У) 


31 спеск-т$ 


2020-03-18 
09:03 
принято содержимое веб-страницы 1еагспеск-п: 9512922400 изег Мападе {адз: гипк 
06:42 
исправлен шрифт горизонтального меню в загловке странички 
спеск-п: а295807се2 изег. Мападег{ад$: 1гипк 
2020-03-17 
17:47 
принят заголовок веб-страницы спеск-п: 56е4а0с86 изег Мападег\адз: {типк 
14:44 
09:41 
добавлено фоновое изображение для заголовков информационных блоков 
спеск-п: 2672495026 изег Оезюпег{а0$: типк 
09:33 


Рис. 4.28 
Шкала времени проекта после вливания ветви «содержимое» 


4.4. Ярлыки и свойства 


4.4.1. Пользовательские идентификаторы 


При работе над проектом средствами Е0$5Й довольно часто приходится 
использовать идентификаторы, чтобы указать командам, над какими именно 
точками сохранения требуется выполнить ту или иную операцию. Эти иденти- 
фикаторы, автоматически присваиваемые системой Ео55И всем появляющимся в 
ней объектам, представляют собой длинные случайные последовательности 
шестнадцатеричных цифр, которые не только сложно запомнить, но непросто 
даже ввести с клавиатуры без ошибок. В связи с этим возникает мысль о том, 
что было бы неплохо некоторым точкам сохранения назначить более удобные 
идентификаторы. 

И система Ео5$Й такую возможность предоставляет. Каждая точка сохра- 
нения в репозитории может снабжаться ярлыком (а) — коротким текстом. Яр- 
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лыки бывают точечными и распространяющимися. Точечные ярлыки «приклеи- 
ваются» к точке сохранения и относятся только к ней. Распространяющиеся яр- 
лыки «приклеиваются» не только к указанной точке сохранения, но и ко всем 
следующим после неё точкам, находящимся на этой ветви. Кроме того, при со- 
здании очередных точек сохранения в той же ветви такие ярлыки автоматически 
копируются и на них. 

Когда создаётся новая ветвь в репозитории, её первой точке сохранения 
автоматически назначается распространяющийся ярлык с таким же именем, ка- 
кое имеет созданная ветвь. Посмотреть список всех использующихся в репози- 
тории ярлыков можно с помощью команды: 


Ео$$11 ад 1156 


Поскольку до настоящего момента никаких ярлыков специально не созда- 
валось, она выведет на экран список наименований имеющихся в репозитории 
ветвей: 


ЕкорК 
заголовок 
содержимое 


При необходимости можно вывести список сущностей, хранящихся в ре- 
позитории и имеющих определённый ярлык. Например, вывести список точек 
сохранения на ветви «заголовок» позволяет следующая команда: 


Ео$$11 Еад Е1па -Е с1 "заголовок" 


В этой команде значение параметра -1, равное с! (свеск-1т), указывает, что 
ожидается вывод только точек сохранения с отфильтровыванием других храня- 
щихся в базе данных элементов. В конце команды указывается значение ярлыка, 
которое интересует пользователя. Для рассматриваемого примера команда вы- 
ведет на экран: 


=== 2020-03-17 === 

09:33:13 [4аес8726е4] подобран шрифт для заголовка и установлено выравнивание 
по левому краю (изег: Тирозег2 ф$адз: заголовок) 

09:24:09 [290а95521] увеличение высоты заголовка (изег: Тирозег2? фадз: 
заголовок) 
06:49:50 [ЧраЕб0е2Ъс] подключено фоновое изображение для заголовка (изег: 
Тирозег2 фад$: заголовок) 

=== 2020-03-16 === 
18:55:29 [7514еа8ба2 ентрирование содержимого заголовка (изег: Тпрозег2 
Тач$з: заголовок) 

18:52:17 [3а6Е997е13] центрирование блока заголовка (изег: ТГпрозег2 фадз: 

заголовок) 
=== 2020-03-13 === 
20:29:14 [9с060ЕЕ071] блок названия организации и её девиза (изег: Ппрозег2 
фачз: заголовок) 

17:52:44 [9359174457] СгеаЕе пем Югапср папе "заголовок" (изег: Мападег ад: 
заголовок) 
+++ по шоге Чаба (7) +++ 
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Название ярлыка можно использовать вместо идентификатора. Выше был 
рассмотрен пример, в котором верстальщики выгружали из репозитория в свои 
рабочие каталоги файлы с изображениями, находящиеся в мгновенном снимке 
рабочего каталога дизайнера. Для доступа к этому мгновенному снимку исполь- 
зовался идентификатор точки сохранения. 

Возможно, было бы удобнее назначить этой точке сохранения ярлык и об- 
ращаться к ней по имени. Попробуем это сделать. 


4.4.2. Точечные ярлыки 


Для «навешивания» ярлыка введём команду: 
Ео$$11 фадч аа "изображения" 4е64309451 


В этой команде «изображения» — это название ярлыка, а 4е6 4309451 — 
идентификатор точки сохранения. Если допустить ошибку в идентификаторе, то 
будет выведено сообщение по! юипа: (не найден) и указан набранный идентифи- 
катор. Если всё в порядке, то команда ничего не сообщит. 

Теперь для того, чтобы посмотреть список файлов, находящихся в мгно- 
венном снимке точки сохранения с идентификатором 4е64309451, можно 
набрать команду: 


Ео$$11 1$ -к "изображения" 


Если ярлык точке сохранения назначил менеджер и он же выполнил ко- 
манду просмотра, то на экран будет выведен список файлов соответствующего 
мгновенного снимка. Если же команду просмотра выполнит другой участник 
проекта, например первый верстальщик, то ему будет выдано сообщение об 
ошибке: по! а уа!а сНеск-т: (недопустимая точка сохранения:) изображения. 

Это не удивительно, потому что информация о назначении ярлыка ещё не 
попала в его репозиторий. Чтобы другие участники проекта могли пользоваться 
ярлыком, менеджер должен сначала загрузить его в репозиторий, а те, в свою 
очередь, должны выполнить синхронизацию своих репозиториев. 

Ситуация несколько усложняется тем обстоятельством, что сам факт 
назначения ярлыка система Роз$31 не считает событием, изменяющим состояние 
рабочего каталога. Оно не отражается в выводе команды 10$$1 за з, а попытка 
загрузки в репозиторий с помощью команды ю$$Й соттй завершается сообще- 
нием: пото Ваз спапдеа; изе --а!ом-етрАу 10 ометае (ничего не изменилось; ис- 
пользуйте --аПо\-етру для переопределения). 

Конечно, ярлык будет загружен в репозиторий в дальнейшем при загрузке 
изменённых файлов рабочего каталога. Но у менеджера необходимость редак- 
тирования файлов может возникнуть нескоро. К счастью, он может воспользо- 
ваться подсказкой Ео$$1 и указать опцию --аЙои’-етриу: 


Еоз$11 сомш1е --а11ом-ешреу -м "назначен ярлык \"изображения\" 
точке сохранения с графическими элементами" 


После этого другие участники проекта могут выполнить команду ие -] 
ирдае, чтобы получить информацию о назначенном ярлыке в свои репозитории. 
Несмотря на то, что команда после выполнения сетевого обмена выведет сооб- 
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щение спапдез: Мопе. Атеаду ир-ю-дае (изменения: Ничего. Уже актуально), на 
самом деле ярлык будет получен. 

В этом можно убедиться, просмотрев список ярлыков командой 10331 {ад 
131 или выполнив приведенную выше команду просмотра списка файлов в 
мгновенном снимке, — она действительно отобразит имена файлов, а не сооб- 
щение об ошибке. Увидеть результат назначения ярлыка точке сохранения мож- 
но и на шкале времени репозитория (рис. 4.29). 


@® этыоЕ эпае-раде мебзйе: Тит хо + 


< - С О не защищено | ю055й.5егуег:8081/бтейте 


Баг” спеск-т ® 4е6430945143Ба9е 


файлы изображений перемещены в подкаталог итадез 
спеск-т: 4264309451 изег Безюпеад$: {гипк, изображения 


добавлены графические элементы для заголовка и 
информационных блоков 
спеск-т: 178еа62035 изег Безюпег{ад$: гипк 


2020-03-13 
20:29 


51: 1866457641 


Рис. 4.29 
Точка сохранения с идентификатором 4е64309451 получила ярлык изображения 
наряду с распространяющимся по ветке ярлыком {типЁ 

Однако ярлыки нельзя рассматривать как полную альтернативу иденти- 
фикаторам точек сохранения. На ярлыки не распространяется требование уни- 
кальности, и наиболее яркий тому пример — названия ветвей разработки. Все 
точки сохранения, находящиеся на одной ветви разработки, имеют ярлыки с 
одинаковыми названиями — {типк, заголовок, содержимое. Можно и явным обра- 
зом «навесить» одноимённые ярлыки на несколько различных точек сохране- 
ния. Например, дизайнер отдельно загрузил в репозиторий фоновое изображе- 
ние для заголовков информационных блоков. Этой точке сохранения тоже мож- 
но назначить ярлык изображения: 


05511 сад ааа "изображения" 2672сас02Ь 
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Теперь В рабочем каталоге менеджера две точки сохранения имеют ярлы- 
ки с одним и тем же названием, что демонстрирует команда: 


05511 Сад Е1пА "изображения" 
2020-03-17 
09:41:18 [2672сас02Ъ] добавлено фоновое изображение для заголовков 
информационных блоков (и5ег: ПРез1дпек фаадз: ЕкипКк, изображения) 
2020-03-15 
18:46:48 [4е64309451] файлы изображений перемещены в подкаталог 
1тадез (изег: 
Рез1апег Еадз: ЕгапКк, изображения) 
+++ по шоге Ааба (2) +++ 


Почему сказано «в рабочем каталоге менеджера», а не «в репозитории»? 
Потому что назначенные менеджером ярлыки попадут в репозиторий только 
после очередной загрузки моментального снимка рабочего каталога. 

В веб-интерфейсе Еоз$5И список действующих в репозитории нераспро- 
страняющихся ярлыков, подобных только что созданному, можно посмотреть 
либо через пункт горизонтального меню Тадз, либо через раскрывающееся ме- 
ню Вгапсвез-Тадз, либо по ОВГ: Вр:/Л№о$$й.зегуиег:8081АадИз( (если сетевой репо- 
зиторий находится на сервере {1ю$$1.зегуег и ожидает подключений на ТСР-порту 
8081), как проиллюстрировано рисунком 4.30. 


= О х 


© тре этае-раде мебзйе: Тадз Х + 
< - С (О не защищено | 10$$1.5егуег:8081 Ладй${ ж [> 
Зипр!е этае-раде меь$Ке / т. Мыпадия — подо 
= Ноте тете ЕИез Вгапспез Тадз Рогит Тске!5 
®» Ноте Раде » Пске5 
» Ее Вгомзег о Кесег{ асймйу 
о Ттее-ме\м, Тгипк Спеск-т о [151 оГАНасптет 
о Наемем » МК 
о НЕ адез Фюг ТгипК о 1151 ОМК Радез 
© Ипуегзюпеа Ейез о Кесеги асвуйу 
®» Ргдес! Титете о Запабох 
о Асйуйу Верой$ о [151 оГАвасптет 
о Не пате спапдез ® 1090щ 
о Рок$ о Спапде Раз$\мога 
о Е!гз{ 10 свеск-т$ ®» Керозцогу За 
®» Вгапспез о СоШзюопз оп ВазВ ргейхез 
о 1151 оГОРЕ$ изед {0 ассез$ {115 герозИогу 
о ГеаРСпеск-т$ о [151 оГАЦИас5 
» Гот о 1151 оЁ"Титемагр" Спеск-т$ 
о Кесеп{ асймйу 


Рис. 4.30 
Переход к списку нераспространяющихся ярлыков 
Список ярлыков представлен гиперссылками (рис. 4.31), при переходе по 
которым открывается веб-страничка с теми точками сохранения на шкале вре- 
мени, которым назначен соответствующий ссылке ярлык (рис. 4.32). 
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© тре этае-раде меБзИе: Тадз Х + 


< - С О незащищено | +055й.5егуег8081 Дадй$+ х @: 


эитр!е зтае-раде ме з$Ке / то мы ооы 


— Ноте Титейпе Ре5 Вгапсвез Тад$ Рогит 


ТПтейпе 


Моп-ргорадаНпа {ад$: 


® | изображения 


Рис. 4.31 
Список нераспространяемых ярлыков 


© тре япа-раде ммебзИе: Тит. ЖХ + 


< -> С О незащищено | 10551.5егуег 8081 Аитейле?{=изображения 
Зипр!е зэтае-раде ме з$Ке / ттеше 


Мападег — Годош 


Ноте Титете Ре$ Вгапсвез Озегз 


АдЗ\МК — АФуапсед [Модет Мем т] Мах! 50 | [Снескалз у] 


2 спескК-тз$ {аддеа ИП "изображения" 


2020-03-17 


41 
с добавлено фоновое изображение для заголовков информационных блоков 


спеск-т: 2672695026 изег Пезюпег {а4$: \гипк, изображения 


2020-03-15 


18:46 = . г 
файлы изображений перемещены в подкаталог итадез 


спеск-т: 4е64309451 изег. Везюпег {ад$: {типк, изображения 


Рис. 4.32 
Точки сохранения, снабжённые ярлыком изображения 


А можно ли теперь использовать ярлык для обращения к точке сохране- 
ния, как это делалось раньше? И если да, то к какой из двух точек сохранения с 
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ярлыком изображения произойдёт такое обращение? Попробуем выполнить ко- 
манду: 


Ео$$11 15$ -к "изображения" 


Команда выполнилась успешно и вывела на экран список файлов: 


1падез/аемо.)ра 
1падез/в2Ькара. ат Е 
1падез/ВагЬкалта.а1Е 
1паех.с$5 
1паех.В 61 
ЪТСЕМЗЕ 
Поскольку в списке присутствует файл В26Кдпа.09й, можно сделать вывод, 
что команда выполнилась над самой поздней из точек сохранения, имеющих 
ярлык изображения. Точно так же использование вместо идентификаторов точек 
сохранения названий ветвей репозитория будет приводить к воздействию ко- 
манд на последние точки сохранения, имеющиеся на соответствующих ветвях. 
Если ярлык был назначен ошибочно или больше не требуется, его можно 
убрать. В приведенном примере моментальный снимок точки сохранения 
2672с9с026 содержит все три файла изображений, созданных дизайнером. По- 
этому снимем ярлык изображения с ранее созданной точки сохранения 
4е64309451 командой: 


Ео$$511 Сад сапсе1 "изображения" 4е64309451 


4.4.3. Распространяющиеся ярлыки 


Мы рассмотрели использование точечных ярлыков и теперь можем пере- 
ключить внимание на распространяющиеся ярлыки. Как уже было сказано вы- 
ше, распространяющийся ярлык, будучи назначенным какой-либо точке сохра- 
нения, автоматически назначается и всем последующим точкам сохранения, как 
находящимся на этой же ветви репозитория, так и на порождённых от неё вет- 
вях. Причём не только новым точкам, но и уже существующим на момент со- 
здания ярлыка. Рассмотрим пример. 

На ветви репозитория «заголовок» верстальщик сначала оформлял текст, а 
в точке сохранения с идентификатором 46аЮ0е26с начал использовать изобра- 
жения. Назначим этой точке сохранения распространяющийся ярлык «заголо- 
вок с изображениями» с помощью команды: 

Еоз$11 фа ааа --ргорадаее "заголовок с изображениями" ЧраЕ60е2рс 


Параметр --рторавеие заставляет назначенный ярлык распространиться на 
все точки сохранения ветви «заголовок», начиная с указанной. В результате эта 
ветвь репозитория приобретёт вид, который можно посмотреть с помощью ко- 
манды: 


Ео$$11 аа Е1па "заголовок" 
Эта команда выведет следующие сведения: 


=== 2020-03-17 === 
09:33:13 [4аес8726е4] подобран шрифт для заголовка и установлено 
выравнивание 
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по левому краю (изег: Тирозег2 фадз: заголовок, заголовок с 
изображениями) 
09:24:09 [5290а95521] увеличение высоты заголовка (азек: Пиарозег2 фадз: 
заголовок, заголовок с изображениями) 

06:49:50 [ЧАБаЕб0е2рс] подключено фоновое изображение для заголовка 
(изег: 

Тирозег2 Еад5з: заголовок, заголовок с изображениями) 

=== 2020-03-16 === 

18:55:29 [7р14еа86а2] центрирование содержимого заголовка (изег: Пирозег2 
ад: заголовок) 

18:52:17 [3а6Е997е13] центрирование блока заголовка (изег: Тирозег2 фадз: 
заголовок) 
=== 2020-03-13 === 
20:29:14 [9с060ЕЕ071] блок названия организации и её девиза (изег: Тпрозег2 
ад: заголовок) 

17:52:44 [9359174457] СхеаЕе пем ЮгапсВ памеЯ "заголовок" (изекг: 
Мападчег фадз: 

заголовок) 
+++ по шоке Ааба (7) +++ 


Несмотря на то, что ярлык «заголовок с изображениями» был назначен 
точке сохранения аБа0е2бс, он появился и у более поздних точек сохранения 
6290а45521 и 4аес8726е4, о чём свидетельствует информация в поле {1а$. Между 
прочим, новый ярлык не заменил ярлык «заголовок», а добавился к нему. Так 
что точки сохранения могут иметь несколько ярлыков. 

Теперь при необходимости можно легко выбрать точки сохранения, соот- 
ветствующие заголовку с изображениями: 


05511 ад Е1пА "заголовок с изображениями" 


Эта команда выведет на экран список из трёх точек сохранения: 


=== 2020-03-17 === 

09:33:13 [4аес8726е4] подобран шрифт для заголовка и установлено 
выравнивание 

по левому краю (изег: Тирозег2 фадз: заголовок, заголовок с 
изображениями) 

09:24:09 [22490аа5521] увеличение высоты заголовка (изег: Тирозег2 
садз: 

заголовок, заголовок с изображениями) 

06:49:50 [ЧБаЕб0е2Ьс] подключено фоновое изображение для заголовка 
(изег: 

Тирозег2 Еадз: заголовок, заголовок с изображениями) 

+++ по шоге Ааба (3) +++ 


Распространение ярлыка, созданного с ключом --рторазие, продолжается 
до тех пор, пока не будет явным образом остановлено. Предположим, что при- 
нято решение ветвь «заголовок» с точки сохранения ЧраЮ0е26с именовать не 
иначе как «заголовок с изображениями». Тогда надо в этой точке сохранения от- 
ключить распространение ярлыка «заголовок» с помощью команды: 


05511 Сад сапсе1 "заголовок" араЕб0е2ьс 
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Теперь команда 10$$1 {ад Ипа «заголовок» выведет на экран только первые 
четыре точки сохранения из этой ветви: 
=== 2020-03-16 === 
18:55:29 [7514еа86а2] центрирование содержимого заголовка (изег: 
Тпрозек2 
ачз: заголовок) 


18:52:17 [3496Е997е13] центрирование блока заголовка (азекг: 
Тпрозетк2 фадз: 

заголовок 

=== 2020-03-13 === 


20:29:14 [9<с060ЕЕ071] блок названия организации и её девиза (изег: 
Тпрозек2 
ач5з: заголовок) 

17:52:44 [939174457] СхеаЕе пем ЮгапсВ памеЯ "заголовок" (изекг: 
Мападчег фадз: 

заголовок 
+++ по шоге Ааба (4) +++ 


Но это не означает, что в репозитории появилась новая ветвь «заголовок с 
изображениями». Ветвей по-прежнему три, в чём можно убедиться с помощью 
команды Ю5$$1 Бгапсп: 


*х Екарк 
заголовок 
содержимое 


Все действия с ярлыками, которые были выполнены, ещё до загрузки в 
репозиторий можно увидеть с помощью команды ю3$5$1 итете: 


=== 2020-03-20 === 

11:29:31 [40е4ееб6с6] Еа1Е [а9аЕб0е2ьсеас83е | ФаЕ60е2Ъс]: Сапсе1 
Таз "заголовок". (изег: Мападег) 

11:26:52 [сЕбОЕсасес] Еа1Е [аБаЕб0е2Ъсеас83е | ЧБаЕ60е2ъс]: Ааа 
ргорадаЕ1па фадч "заголовок с изображениями". (и5ег: 

Мапачег) 

11:25:16 [8914са4105] Еа1е [178еар2035929Еес | 178еар2035]: Сапсе1 
фаз "изображения". (изег: Мападег) 

=== 2020-03-19 === 

18:23:47 [ЪЕЕ5765496] Еа1Е [178еаб2035929Еес | 178еаЪ 2035]: Ааа вачз 
"изображения". (и5ег: Мападег) 

18:01:14 [с1е0еб85а7] Еа1е [2672сас025453Е65 |2672сас025]: Ааа ад 
"изображения". (изег: Мападег) 


15:48:39 [6а77с704Е6] *СУВВЕМТ* назначен ярлык "изображения" точке 
сохранения с графическими элементами (изег: Мападех 

Тачз: ЕгипКк) 
15:15:45 [Е799095803] Еа1еЕ [4е6430945143Ьа9е | 4еб 4309451]: Ааа кач 
"изображения". (изег: Мападег) 
15:15:43 [62е0895010] Еа1Е [4е6430945143Ъа9е | 4еб 4309451]: Ааа фачз 
"изображения". (изег: Мападег) 

=== 2020-03-18 === 

09:03:17 [951е92е400] *МЕВСЕ* принято содержимое веб-страницы (и5ек: 
Мападчег фФадз: Екипк) 


136 


06:42:20 [а295807се2?] исправлен шрифт горизонтального меню в за- 
гловке странички (азег: Мападег Фадз: ЕгипкК) 

=== 2020-03-17 === 
17:47:37 [56е4а0с8Е6] *МЕВСЕ* принят заголовок веб-страницы (изег: 
Мападчег фФадз: ЕгипК) 
14:44:46 [Ес6890Еа2] подключено фоновое изображение к заголовкам 
информационных блоков (пизег: Тирозет1 фад5: 

содержимое) 
09:41:18 [2672сас025] добавлено фоновое изображение для заголовков 
информационных блоков (пзег: Пез1апехг фадз: Егапк, 

изображения) 
—-- 11ре 1116 (20) геасВеа --- 


Такие записи имеют отметку Ей (Редактирование) и одну из расшифро- 
вок: Ада {ад (Добавлен ярлык), Ад ргорадайта {ад (Добавлен распространяю- 
щийся ярлык) и Сапсе! {ад (Отменён ярлык). 

А что произойдёт, если отменить распространение ярлыка «заголовок» в 
самой первой точке сохранения одноимённой ветви репозитория? Выполним 
команду: 


Еоз$11 фа сапсе1 "заголовок" 935917447 


После этой команды никакие точки сохранения больше не отмечены яр- 
лыком «заголовок», в чём можно убедиться с помощью команды: 


Ео$$11 аа 1156 


Она выведет на экран названия всех имеющихся в репозитории ярлыков, 
среди которых не будет названия «заголовок»: 


Е гопкК 

заголовок с изображениями 
изображения 

содержимое 


В то же время команда 03$ БгапсН будет, как и раньше, отображать три 
ветви: {гипк, заголовок, содержимое. 


4.4.4. Свойства 


Почему же ветвь «заголовок» не пропала из списка вместе с одноимён- 
ным ярлыком или хотя бы не сменила своё название? Дело в том, что в репози- 
тории Е0$$Й все ярлыки, как точечные, так и распространяющиеся, являются 
свойствами. Свойство — это атрибут, имеющий имя и значение. В каком-то 
смысле свойство можно сравнить с переменной в языках программирования. 

Ярлык — это свойство с именем зут-НазваниеЯрлыка и пустым значени- 
ем. Чтобы посмотреть список имеющихся в репозитории свойств, можно вос- 
пользоваться командой: 


Ео$$11 аа 1156 --гам 
Ключ --гаи’ заставляет команду вывести на экран перечень свойств, а не 
ярлыков, как это делалось раньше: 
ргапсьВ 
с1озеа 
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зум-ЕкипкК 

зум-заголовок 

зум-заголовок с изображениями 
зуп-изображения 
зум-содержимое 


Чтобы переименовать ветвь репозитория, надо свойству Бгапсй первой 
точки сохранения на этой ветви присвоить значение нового имени. Например, 
чтобы все ветви были обозначены русскими словами, можно ветвь 1гипК пере- 
именовать в «основная». Для этого достаточно выполнить команду: 


Ео$$11 Еаа аа --гам --ргорадаее ЮгапсВ 24е23с5сЕБ "основная" 


Важно указать ключ --гау’, потому что без него вместо присвоения значе- 
ния «основная» свойству Бгапсй будет создан обыкновенный ярлык бгапсН 
(свойство зут-Бгапсй без значения). 

После переименования команда {0$ БгапсН выводит названия ветвей так: 


заголовок 
* основная 
содержимое 


Однако все точки сохранения, находящиеся на ветви «основная», по- 
прежнему снабжены ярлыками {гипк. И заменить их на ярлыки «основная» не 
так просто. Отмена ярлыков {гийК реализуется командой: 


Ео$511 ад сапсе1 "фкопКк" 24е23с5сЕЪ 


Но если для назначения новых ярлыков «основная» выполнить приведен- 
ную ниже команду, то эти ярлыки получат Также точки сохранения на ветвях 
«заголовок» и «содержимое», выращенных позже на основной ветви ‘гипкК в ходе 
развития проекта. 


Ео$$11 сад ааа --ргорадаее "основная" 24е23с5сЕБ 
Чтобы восстановить логику, придётся выполнить команды прерывания 


распространения ярлыка «основная» в первых точках сохранения, находящихся 
на ответвлениях: 


Ео$$11 Еадч сапсе1 "основная" 935917447 
Ео$$11 ад сапсе1 "основная" Яас3084089 


Результат переименования можно записать в репозиторий командой: 


Ео$$11 соти1е --а11ом-ешреу -м "переименована ветвь \"ЕгопКк\" в 
\"основная\"" 


После переименования основная ветвь изменит свой цвет на шкале вре- 
мени. Но эта проблема поправима. Устанавливать фоновый цвет для точек со- 
хранения на шкале времени можно с помощью свойства Бдсог. Например, что- 
бы последняя точка сохранения с ярлыком «изображения» отображалась на 
пурпурном фоне, надо ввести команду: 


Еоз$11 фадч аа --хгам Басо1ог "изображения" падеп ва 
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А если попытаться перекрасить точки сохранения ветви «основная» с по- 
мощью приведенной ниже команды, то получится неприятный сюрприз: лазур- 
ный фон распространится и на ответвления. 


Еоз511 сад ааа --гам --ргорадаее Юдсо1ог 24е23с5сЕр суап 
Исправить ситуацию можно установкой в первых точках сохранения от- 
ветвлений явного запрета на распространение этого свойства: 


05511 ад сапсе1 --кам Басо1ог 935917447 
Ео5511 ад сапсе1 --кам Расо1ог 99с3084089 


Результаты переименований и перекрашиваний надо записывать в репози- 
торий командой ю$$1 соттй с ключом --аЙом’-етриу. После проделанных опера- 
ций шкала времени в веб-интерфейсе приобретёт вид, показанный на рисун- 
ке 4.33. 


Эитр!е это!е-раде мебзНе: Тито Х + 
оте-р 


< -> С О не защищено | {055й.5егуег8 081 Аитейте?г=основная8с=2020-03-17+09%3А41%3А18 х ©® 


17:47 


14:44 


09:41 


[= 
[е] 
[< 
© 


2020-03-15 
18:46 


16:06 


2020-03-13 :} ы 


Рис. 4.33 
Шкала времени после переименований и перекрашиваний 
Несмотря на то, что путём модификации значений свойств БгапсН и Б9союг 
можно переименовать и перекрасить ветви репозитория, во избежание лишней 
работы и побочных эффектов лучше давать им сразу предпочтительные назва- 
ния и цвет при ответвлении с помощью команды: 


Ео5$11 БгапсВ пем --расо1ог ЦветФона НазваниеВетви ТочкаОтветвления 


В приведённой команде ключ --Бесоог позволяет указать фоновый цвет 
для точек сохранения ветви, который будет использован вместо цвета, автома- 
тически предоставляемого системой Е05$1. Завершают команду два парамет- 
ра — собственно название ветви и идентификатор (или ярлык) точки сохране- 
ния, в которой создаётся ответвление. 
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Система Ео3$ позволяет использовать одинаковые имена для разных вет- 
вей. В этом случае при указании названия ветви в командах они будут приме- 
НЯТЬСЯ К ТОЙ ветви, на которой находится самая последняя точка сохранения. 


4.4.5. Исправление значений свойств 


Возможность изменения свойств элементов репозитория придаёт системе 
гибкость, однако пользоваться этой возможностью следует с осторожностью и 
по необходимости. Например, после переименования основной ветви репозито- 
рия из «вгипК» в «основная» команда открытия репозитория на новом рабочем 
месте ю3$Й ореп ..\ззрммебзйе-юса!1ю$$Й перестанет работать и начнёт сообщать 
об ошибке: 


поЕ Еоппа: Егапк 


Дело в том, что эта команда по умолчанию ищет последнюю точку сохра- 
нения на ветви с именем {гипК, а теперь такая ветвь в репозитории отсутствует. 
Для того, чтобы открыть репозиторий в новых условиях, придётся явным обра- 
зом указывать в команде название ветви: 


Ео0$5811 ореп ..\ззрмерз1Ее-1оса1.Еоз5$11 "основная" 


Таким образом, перед внесением изменений стоит подумать, перевешива- 
ет ли прогнозируемый результат те проблемы, с которыми придётся столкнуть- 
ся. С другой стороны, не исключены ситуации, когда при создании новой ветви 
в её названии была просто допущена опечатка, которую заметили лишь спустя 
некоторое время. В этом случае, конечно, ошибку лучше исправить. 

Но для этого есть более простой способ, чем тот, который описан выше. 
Например, вернуть основной ветви репозитория первоначальное название поз- 
воляет команда: 


Ео$$11 амепа 24е23с5сЕБ --БгапсВ ЕгиапКк 


В этой команде 24е23с5с® — это идентификатор точки сохранения, с ко- 
торой начинается ветвь, требующая переименования, а с помощью параметра 
--Бтапсй указывается требуемое имя. В случае успеха команда выведет следую- 
щее сообщение: 


01а: 24е23с5сЕЮЬра7Ье781а6а856е7аЯс8е12е9сас4 2020-02-29 07:24:50 ОТС 
Тачз: Египк 
сопмепе: 1п0161а1 ешрЕу спеск-1п (азег: бебир0Озег) 


В первой строке указано полное значение идентификатора точки сохране- 
ния и время её создания, во второй строке — ассоциированные с ней ярлыки, а 
в третьей — её описание. Остаётся лишь загрузить выполненную операцию в 
репозиторий командой: 


05511 сошм1Е --а11ом-ешрЕу -м "Основной ветви возвращено первона- 
чальное имя" 


Очевидно, что использование команды {10$$1 атепа гораздо удобнее, чем 
серии манипуляций с изменением значений свойств. Поэтому рассмотрим ещё 
один полезный пример её применения. Ветви создаются не так часто по сравне- 
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нию с записью в репозиторий мгновенных снимков рабочих каталогов. Коман- 
ды 1055! соттй набираются разработчиками практически в автоматическом ре- 
жиме, и тем досаднее ошибки, которые легко пропустить в описании выпол- 
ненных изменений. К счастью, их можно легко исправить, воспользовавшись 
только что рассмотренным приёмом. 

Если теперь уже стало понятно, что переименовывать основную ветвь — 
не самая лучшая идея, то изменение описания первой точки сохранения не 
должно отразиться на работоспособности репозитория. Поэтому выполним ко- 
манду: 


05511 амепа 24е23с5сЕф -м "начальная пустая точка сохранения" -- 
ааЕПог Мападегк 


Как и в случае переименования ветви, сначала указывается идентифика- 
тор точки сохранения, на которую действует команда — 24е23с5с®. А затем с 
помощью параметра -т указывается текст нового описания. Заодно можно из- 
менить имя пользователя, создавшего точку сохранения. Для этого служит па- 
раметр --аи йог. В результате выполнения команда вывела обновлённые сведе- 
ния о точке сохранения. 


ии1А: 24е23с5сЕБора7юе781а6а8 5 6е7аас8е12е9сас4 2020-02-29 07:24:50 ОТС 
Тачз: Египк 
сопмепе: начальная пустая точка сохранения (изег: Марадег) 


Чтобы внесённые изменения сразу отразились в репозитории, выполним 
их загрузку: 


05511 сошт1е а11ом-ешрЕу -м "исправлен комментарий начальной 
точки сохранения" 


В результате произведенных манипуляций начальная точка сохранения в 
репозитории приобрела вид, показанный на рисунке 4.34. 


@ тре эта-раде мебзИе: Тит. Х + 


= С О не защищено | #ю$$й.5егуег:8081/итейпе х © 


ин _ Бит приведен КСТОНДВР НТН деда оознозьи онео вия | 
” . _ Добавлен НТМльаблон ИЖ моно оныунсь етих 


2020-02-29 


Рис. 4.34 


Начальная точка сохранения с новым автором, описанием 
и восстановленным названием ветви 
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Оказывается, выполнить все описанные действия можно через веб-интер- 
фейс. Для этого потребуется отыскать на шкале времени точку сохранения, 
в свойства которой надо внести изменения (что в описываемом примере не со- 
ставляет труда), перейти по гиперссылке с её идентификатором, обозначенным 
сНнеск-т, и в открывшемся окне воспользоваться гиперссылкой ейй в строке 
Опег Ипкз: (рис. 4.35). 


2020-02-29 
07:24 


© $тыое эпае-раде мебзйе: СВЕ Х + 


= С О Не защищено | ю0551.5егуег 8081 Итбо/24е... 3 = 


тре зтае-раде мебзКе / г 
Спеск-шт [24е23с5с®] 


Мападег — одош 


=  Ноте Пте!шпе Озег$ 


Оуеглем 


Соттеп{: начальная пустая точка сохранения 
Домутоа4$: Тагра! | ЙР агспме | ЗО агсме 
Ите!тез: Гатйу | Чезсепдап{$ | & гипК 
РИез: Пе | Ше адез | юегх 


$НАЗ-256: 3 24е23с5с®ЬБа7Ье7819ба856е7адс8е 
12е9сас47142ее 256е2634188{1е7684 


Узег & Озме: Мападегоп 2020-02-29 07:24:50 
Опдта! Соттеп:: шп\а!етрйу сВеск-п 
Опадта! Узег & Озе: ЗешрИзег оп 2020-02-29 07:24:50 
Весемед Егот: ЗеирОзег @ оп 2020-02-29 07:24:50 
АЗа МКГ: {15 спескКт | {гипк 
ОЧпег МпК$: тапИез | {ад$ | пйпК{аЫе |едй) 


Рис. 4.35 
Переход к форме редактирования свойств точки сохранения 
В окне веб-браузера откроется форма изменения свойств выбранной точ- 
ки сохранения (рис. 4.36), поля которой заполнены текущими, недавно установ- 
ленными, значениями. Рассмотрим элементы управления этой формы более по- 
дробно. 
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== О х 
© тре эпае-раде мебзие: 0 Хх + 


< С О не защищено | 1055й.5егуег8081/с1 еЧИ?г=24е2Зс5сЬЬа7Бе й © 


тре зтае-раде меь$Ке / ечл снескап рае2зс5сы] 


Мападег — Годош 


= Ноте Титетпе Еез Вгапспез Узегз 


Маке спапдез {10 айпЬщез ог спеск-т [24е23с5с®] 


Узег: Мападег 


Соттеп\{: начальная пустая точка сохранения 


Снеск-т Тите: (2020-02-29 07:24:50 
Васкогоип4 Соог: Спапде Баскагоипа союг БЕЯ 
“! Ргорадае со]ог {о дезсепдаг 


Тадз: Ааа {пе То!о\ммпа пем {ад пате {о {7115 спеск-тп 


Сапсе! зремаНад Бусо!ог 
Сапсе! зреса ад изег 


Вгапсйп9: Маке {115 сВеск-т {пе зай оГа пеми Бгапсй патед: ‘гипк 
Вгапси Н9: Ное Бгапсв 4гипК гот фе итешпе зайта пот 1$ спеск-п 
Вгапсй Созиге: МагК БгапсВ гипК аз "с1озед" 


Сапсе! || Ргемем 


Рис. 4.36 
Форма изменения свойств точки сохранения 


В строке редактирования ЦУзег можно указать идентификатор пользователя 
репозитория, который будет назначен автором этой точки сохранения. В тексто- 
вое поле Соттеп{ можно ввести новое описание точки сохранения. В строке ре- 
дактирования Спеск-т Тите указаны дата и время создания точки сохранения. 
При необходимости это значение тоже можно изменить. 

Группа элементов управления Васкогоипа Соог позволяет изменить цвет 
фона выбранной точки сохранения. Для этого надо установить флажок Спапде 
БаскКдгоипа соог и выбрать желаемый цвет из палитры, которая появляется при 
щелчке по образцу цвета, отображаемому справа от флажка. Установка флажка 
Ргорадае со!ог 10 Чезсепаап{з приведёт к распространению выбранного цвета на 
всех потомков этой точки сохранения. 

Группа элементов управления Тад$: предназначена для изменения ярлыков 
точки сохранения. Если установить флажок Ада {пе Ю!По\мипд пем {ад пате 10 11$ 
спеск-т, то точке сохранения будут назначены ярлыки, перечисленные в строке 
ввода справа от этого флажка. С помощью флажков Сапсе! зрес!а! {ад Басоог и 
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Сапсе! зреса! 1ад изег можно прекратить действие специальных ярлыков 69с0!0г 
(цвет фона) и изег (имя пользователя) соответственно. 

Чтобы изменить название ветви, которую начинает редактируемая точка 
сохранения, надо установить флажок ВгапсП!по: и ввести новое название в стро- 
ку редактирования, расположенную справа от него. 

Установка флажка Вгапсп Н&4тд приведёт к тому, что эта и последующие 
точки сохранения на текущей ветви не будут отображаться на шкале времени. 
Это может быть полезно для сокрытия ветвей, которые были созданы с целью 
проверки идей, впоследствии признанных бесперспективными. 

И, наконец, установка флажка ВгапсН С!озиге приведёт к закрытию теку- 
щей ветви, т. е. запрету дальнейшей записи в неё мгновенных снимков рабочего 
каталога. 

После заполнения формы надо нажать кнопку Ргемем (Предпросмотр), в 
результате чего в верхней части формы на фоне выбранного цвета отобразится 
новый текст комментария с новым именем пользователя и новыми тегами, а в 
нижней части формы появится кнопка Арру Спапдез (Применить изменения), с 
помощью которой выполненные изменения могут быть применены к точке со- 
хранения. 
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Глава 5 
СИСТЕМА УЧЁТА ЗАЯВОК 
НА ДОРАБОТКУ 


5.1. Требования 
к разрабатываемому продукту 


Рассмотренная в предыдущих главах система контроля версий является 
одним из важнейших, но не единственным инструментом, улучшающим про- 
цесс разработки. Она упорядочивает только один его аспект — работу с исход- 
ными текстами разрабатываемого продукта. Но есть и другие, например работа 
с требованиями к системе. 

При проектировании системы составляется список требований, кото- 
рым она должна удовлетворять. Требования могут быть функциональными 
(перечень функций, которые система должна реализовывать) и нефункцио- 
нальными (минимальные уровни производительности, точности, надёжности 
ит. п.). В ходе разработки продукт проверяется на соответствие предъявляе- 
мым к нему требованиям. Когда все предъявленные требования будут выпол- 
нены, программа считается готовой к выпуску в опытно-промышленную экс- 
плуатацию. 

Редко бывает, чтобы выпущенная в эксплуатацию система не имела ни- 
каких недостатков. Возможно, какое-то из требований было упущено на этапе 
контроля качества. Может проявиться какой-нибудь просчёт, не учтённый при 
проектировании. Случается, что какие-то нефункциональные требования 
надо ужесточить, чтобы улучшить эксплуатационные характеристики си- 
стемы. 

Недостатки после их обнаружения должны быть сформулированы, 
оформлены как претензии или пожелания и переданы разработчику программ- 
ного продукта в виде заявок на доработку. В системе Ео$5И имеется подсистема 
для учёта таких заявок. Несмотря на то, что взаимодействовать с этой подси- 
стемой можно из командной строки с помощью команд $$й #ске+..., удобнее ра- 
ботать с ней через веб-интерфейс. 

Чтобы приступить к работе с заявками на доработку, надо выбрать пункт 
Тске! в горизонтальном или раскрывающемся меню (рис. 5.1) или ввести в ад- 
ресной строке веб-браузера ЦРЕ: П{р:/Моз$1.зегуег:8081/скеф, где 1ю0$$1.зегмег — 
сетевое имя сервера, а 8081 — номер ТСР-порта, на котором система Ео$$1 при- 
нимает сетевые подключения. 
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© 5тье эпае-раде мебзйе: Тк Хх + 


< - С О незащищено | +05$51.5егуег 808 1/йске! х & 


Зитр!е зта!е-раде мез$Ке / тек мам мепи седел — подом 


— Ноте Титейпе Р{е5 Вгапспез Тадз Рогит Тске5 
®» Ноте Раде ® Рот 
. ев о _Кесег{ асбуцу 
[:] ми, Тгипк Спеск-п 
о о Кесег{ асбуйу 
о Ее адез {ог ТгипК о [151 оГАЦасптеп 
© Ипуегзюпед Ейез » МК 
® Ргоес! Титейпе о [151 оГМИК! Радез 
о АсНуйу Керой$ о Кесеп{ асйуйу 
о Ре пате спапдез о Запабох 
о Гож$ о [151 оГАЧасптет 
© ЕгзЁ 10 спеск-пт$ ® 1090щ 
® Вгапсвез о Свапде Раззмога 
о Тадз 


о [еаГСпеск-т$ 


Рис. 5.1 
Переход к работе с заявками на доработку 


5.2. Создание заявки на доработку 


Продолжим рассмотрение примера разработки одностраничного веб- 
сайта небольшой командой специалистов. Основная часть работы к этому вре- 
мени уже выполнена, и менеджер попросил дизайнера проверить веб-страничку 
на соответствие макету. Первым делом дизайнер выгрузил из репозитория в 
свой рабочий каталог последний вариант файлов проекта с помощью команды: 


Ео$511 прдафе 


Затем он открыл файл таех.пт! в веб-браузере и начал проверку. На пер- 
вый взгляд всё выглядело неплохо. Но стоило ему уменьшить размер окна, как 
иллюстрации информационных блоков наехали на текст и сплющили его в 
узенькие колонки. 

Дизайнер понимал, что верстальщикам это было трудно предвидеть по 
статическому макету, но такая реализация веб-странички была неприемле- 
мой — она бы отпугнула от неё пользователей мобильных устройств. Поэтому 
он открыл веб-интерфейс на страничке заявок на доработку и выбрал гиперс- 
сылку Меми иске! (Новая заявка) (рис. 5.2). 

В веб-браузере открылась форма для заполнения, показанная на рисун- 
ке 5.3. 

Форма состоит из семи полей. В первом поле Ещег а опе-йте зиттагу ое 
{ске!: предлагается ввести краткое описание заявки одной строкой. 
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57 | х 
© тре эта-раде мебзйе: Ткр Хх + 


< -> (С Фнезащищено | #0$51.5егуег8081/9ске! х ©: 


Зипр!е этае-раде меь$Ие / тек мат мепи сено — подом 


= Ноте Тите!пе Рез Вгапсвез 


Ег{ег а пе\и искее 


® | Мем иске! 


Споозе а герой {опта! гот {Пе го!омипд Е 


1. АН Тске!з [сору] [59] 


Рис. 5.2 
Создание новой заявки на доработку 


© тре эпае-раде змебзИе: Мех Х + 


< -> С А нНезащищено | 105$1.5егуег:8081 /Акелеми х ©: 


Зипр!е зэта!е-раде мер $Ке / мех текее сеет подом 


= Ноте Титейпе Р!е$ Вгапспез 


Ещег А Мем/ Пске{ 


Еп{ег а опе-йпе зиттагу о! {е ЧсКеЕ 
Не масштабируются иллюстрации информационных блоков] 


Туре: [Реаиге_Ведие*{ _*\ Мпа уре о иске! 1$ #15? 
Мегзюп: [6221879596 | |п ма уегзюп ог Бийа питБег до уоц обзегуе пе 
ргоЫет? 
о и Ном де айпод 15 пе ргоБет? Но\м/ Баду доез пе 
Зеинйу: Соне +1 ргоЫет айес! {Пе орегайоп о! Пе ргодис!? 
ЕМай: |дезюпег@!'юоз$$1.зегуег ты мые Цзед Бу демеорегз {0 сощас!уои мВ 


Етмег а де{айед дезспрйоп о {пе ргоЫет. Рог соде деес5, Бе зиге {10 ргомае де{ай$ оп ехасйу пом пе 
ргоЫет сап Бе гергодисечд. Ргомае аз тисп де{ай аз роз е. ГоптаЕ |Р!ат Тех у 

Иллюстрации информационных блоков не уменьшаются при уменьшении 

размеров окна веб-браузера, что приводит к искажению отображения 


текста. Надо, чтобы размеры иллюстраций всегда были пропорциональны 
видимым размерам информационных блоков. 


Ргемем ФИ Зее По\и {пе дезспрйоп ми! арреаг айег фогта пд. 
Сапсе! | АБапдоп апа Гюгде! {95 иске! 
Рис. 5.3 


Форма для заполнения новой заявки 
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Во втором поле Туре: предлагается выбрать тип заявки из следующих ва- 
риантов: 

® Соде Оеес! — ошибка в коде; 

® Виа Рю ет — проблема сборки; 

® ОоситещаНоп — документация; 

® Геавге_Редие${ — запрос на доработку; 

® поет! — инцидент, проблема с безопасностью. 

В третьем поле \егз!оп: надо ввести информацию о версии продукта, к ко- 
торой относится создаваемая заявка. 

В четвёртом поле Зеуету: предлагается указать степень серьёзности про- 
блемы, которая послужила причиной создания заявки. На выбор даются следу- 
ющие варианты: 

® СШса! — критическая, продукт невозможно или недопустимо исполь- 
зовать до устранения проблемы; 

® Зе\уеге — серьёзная, использование продукта с этой проблемой может 
привести к неприятностям; 

® |троЦап{ — важная, проблема должна быть устранена в самое ближай- 
шее время; 

® Мпог — незначительная, заявку надо выполнить по мере возможности; 

® Созтейс — косметическая, пожелание по поводу улучшения системы. 

В пятом поле ЕМай: надо ввести адрес электронной почты автора заявки. 
Несмотря на то, что доступ к подсистеме управления заявками есть у многих 
пользователей, введённая в это поле информация будет доступна только разра- 
ботчикам. С её помощью они смогут уточнить вопросы, которые могут по- 
явиться при работе над заявкой. 

В последнем большом текстовом поле предлагается ввести подробное 
описание проблемы, которая явилась причиной создания заявки. Здесь жела- 
тельно написать о том, как описанную проблему можно воспроизвести (ведь 
чтобы её устранить, надо видеть, что устранять). 

Над текстовым полем находится поле выбора из списка способа, каким 
будет оформлен текст описания проблемы. Доступны следующие варианты: 

® МК — разметка, принятая для написания статей в Ут; 

® НТМЕ — гипертекстовая разметка для веб-страниц; 

® Раш Тех{ — обычный текст; 

[пкз опу] — текст с распознаванием ссылок на сущности системы 
ЕРо$$1 в виде [Идентификатор]. 

Дизайнер заполнил поля формы по возникшему у него вопросу и нажал 
кнопку Ргемем (Предпросмотр). В окне отобразился текст набранного им опи- 
сания проблемы и появилась кнопка Зибтй (Отправка). Проверив текст описа- 
ния и не обнаружив в нём ошибок, дизайнер нажал кнопку Зибтй. В окне отоб- 
разилась карточка заявки, созданной дизайнером (рис. 5.4). 
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Иллюстрации информационных блоков не уменьшаются при уменьшении размеров окна 
веб-браузера, что приводит к искажению отображения текста. Надо, чтобы размеры 
иллюстраций всегда были пропорциональны видимым размерам информационных блоков. 


Рис. 5.4 
Карточка созданной заявки 


5.3. Прикрепление поясняющих материалов 


Первым эту заявку увидел менеджер во время очередного обхода системы 
учёта заявок. Он зашёл на веб-страницу этой системы и перешёл по гиперссыл- 
ке А! Тске{$ (рис. 5.5). 

В веб-браузере отобразилась таблица с заявками на доработку, в которой 
помимо заголовка присутствует единственная строка, соответствующая создан- 
ной дизайнером заявке (рис. 5.6). Таблица состоит из семи колонок. В первой 
колонке находится гиперссылка с идентификатором заявки, во второй — дата и 
время её создания (изменения), в третьей — тип заявки, в четвёртой — еб со- 
стояние, в пятой — подсистема, к которой она относится, в шестой — краткое 
описание. И, наконец, в седьмой колонке размещена гиперссылка ед, по кото- 
рой можно перейти в режим редактирования заявки. 
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Рис. 5.5 
Переход на список заявок 
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Рис. 5.6 
Таблица с заявками 
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Чтобы ознакомиться с подробным описанием заявки, менеджер перешёл 
по гиперссылке 41а592еесо, расположенной в первой колонке. Открылась кар- 
точка заявки, содержащая всю информацию, введённую при еб создании. Мене- 
джер открыл в веб-браузере файл таех.Мт! из рабочего каталога и убедился, что 
описанный в заявке недостаток действительно присутствует. 

Для наглядности менеджер репгил добавить к заявке иллюстрацию, на ко- 
торой демонстрируется изложенная в ней проблема. Он подготовил файл со 
снимком экрана, а затем выбрал пункт АнасН (Прикрепить) в дополнительном 
горизонтальном меню карточки заявки, которое расположено между содержи- 
мым карточки и главным меню системы Го5$1 (рис. 5.7). 
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Иллюстрации информационных блоков не уменьшаются при уменьшении размеров окна веб- 
браузера, что приводит к искажению отображения текста. Надо, чтобы размеры иллюстраций 
всегда были пропорциональны видимым размерам информационных блоков. 


Рис. 5.7 
Переход к форме присоединения файла к заявке 
В открывшейся форме менеджер нажал кнопку Выберите файл, в появив- 
шемся стандартном окне диалога указал на файл со снимком экрана и нажал 
кнопку Открыть (рис. 5.8). Затем в поле Оезсирйоп: (Описание) набрал текст, по- 
ясняющий назначение прикрепляемого файла. Когда всё было сделано, он 
нажал кнопку Ада АНасптеп{ (Добавить Вложение). 
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Присоединение файла к заявке 


После выполненных действий в нижней части карточки заявки появился 
раздел АНаснтепт: (Вложения), в котором приведены сведения о прикреплён- 
ном файле и имеется гиперссылка [9е{айз] (подробности), позволяющая посмот- 
реть изображение снимка экрана (рис. 5.9). 

Но почему добавлением снимка экрана занимается менеджер? Почему это 
не сделал дизайнер самостоятельно? Дело в том, что у дизайнера не было пол- 
номочий для выполнения этой операции, у него даже отсутствовал пункт меню 
АнасН в горизонтальном меню карточки заявки. 

Чтобы пользователь Роз; мог прикреплять файлы к заявкам на доработ- 
ку, в карточке его учётной записи должна стоять отметка АНасптетз (Вложе- 
ния). Она добавляет букву Б к строке разрешённых действий пользователя учёт- 
ной записи (рис. 5.10). 

На шкале времени в веб-интерфейсе Ео5$Й менеджер отыскал точку со- 
хранения, в которой было задействовано изображение для иллюстрации инфор- 
мационных блоков, и навёл курсор мыши на узел, соответствующий этой точке 
сохранения. Всплыло окно, в котором отобразился идентификатор точки сохра- 
нения. Менеджер щёлкнул левой кнопкой мыши по пиктограмме, изображённой 
слева от идентификатора, и идентификатор сохранился в буфере обмена 
(рис. 5.11). 


152 


АНасптеп$: 
 поцЫерпд аддед Бу Мападег оп 2020-03-21 18:12:50 5 | 


Оуегмем 


АпНас! 10: 975045613891с09079с849659сс982е694с9с94625ае120636с56642а62а31 
ТПскеЕ; 41а592еес0!За7сЗа2Ба0е4а64535642аке7Та9с 
Оайе: 2020-03-21 18:12:50 
Узег: Мападег 
АПИНас* АЧасНеЯ: 629998187 Вее5Бе9920сс1175452194445665ае1638Ба259454аа21652ае М 
РИепате: гоцЫе.рпд 
Оезсир#оп: Демонстрация проблемы. 


Сотеп! АррепаеЯ 


(Ше 5 248628 Буе5$ оНтаде ааа) 


= о х 
© тре япае-раде мебзне х + 


< > С Фо | олозя/Мападеглме6зИеЛидехни! #2 @ 


Сотрапу 


Гогет 
1рзит 9400г 
й ате!, 
сопзесеиг 
адр5ста 


Рис. 5.9 
Просмотр прикреплённого к заявке файла 
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Рис. 5.10 
Предоставление разрешения на прикрепление файлов 
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Рис. 5.1 
Копирование идентификатора точки сохранения на шкале времени в буфер обмена 

Затем менеджер вернулся к карточке заявки и выбрал пункт меню ЕЧй. 
Открылась форма редактирования заявки, в которой многие поля повторяют те, 
что были на форме заполнения заявки, но есть несколько новых. 

Поле Заше: (состояние) позволяет выбрать вариант, отражающий этап 
существования заявки, из списка: 

® Ореп — только что создана; 

\епйеа — проверена; 

Веме\м — на рассмотрении; 
Реетед — исполнение отложено; 
Нхе — доработка выполнена; 
Тезед — доработка проверена; 

® С105е4 — закрыта. 

В поле Риогйу: (Приоритет) можно указать срочность выполнения работ 
по заявке, выбрав из списка одно из значений: 

® |ттефае — выполнить прямо сейчас; 

Нов — сделать как можно быстрее; 
Мефит — сделать в рабочем режиме; 
Ёом/ — сделать по мере возможности; 
Гего — выполнять не обязательно. 

Поле Везоийоп: предназначено для указания решения, принятого в отно- 
шении описанной в заявке ситуации. В нём может быть выбрано одно из сле- 
дующих значений: 

Ореп — заявка находится в работе; 

Рхед — заявка выполнена, проблема устранена; 

Веецеа — заявка отклонена; 

М/огкагоипа — предложено обходное решение, костыль; 
ЦпаЫе_То_Вергодисе — описанную в заявке проблему не удаётся вос- 
произвести; 

® \/окз Аз _Оездпед — система работает именно так, как было задумано; 

® Ежета!_Вид — причина проблемы находится за пределами системы; 

® №1: А_Вид — то, что описано в заявке, не является проблемой; 

® Оирсае — заявка дублирует ранее поданную; 
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® Оуегсоте_Ву_Еуеп — отношение к описанной в заявке проблеме из- 
менилось в результате произошедших событий; 

® МсопйдигаНоп — проблема в настройках системы. 

Менеджер поставил отметку Ме!еа в поле Заз, значение Мефит в поле 
Риощу и написал поручение верстальщику трозег1 разобраться с описанной в заяв- 
ке проблемой. К тексту поручения он добавил сохранённый в буфере обмена иден- 
тификатор точки сохранения, заключив его в квадратные скобки. Чтобы такая ссыл- 
ка на точку сохранения сработала, он проверил установку формата добавляемого 
сообщения в значение [йпК$ оп], потому что при использовании формата [Р!ат Тех{ 
введённое значение не было бы выделено из остального текста (рис. 5.12). 
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Действительно, непорядок. Антон Викторович, посмотрите, 
что можно сделать по этому вопросу: [#658901а2454143]. 
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Рис. 5.12 
Форма редактирования заявки 
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Завершил редактирование менеджер нажатием кнопки Ргемем (Предпро- 
смотр) и появившейся после этого кнопки Зибтй (Подтверждение). В результа- 
те состояние заявки изменилось на \еп#еч, а на карточке заявки в секции Цзег 
Соттет: (Комментарии Пользователей) появился текст поручения менеджера 
с активной гиперссылкой [{<668901а2454143], по которой можно сразу попасть на 
соответствующую точку сохранения. Более того, у точки сохранения на шкале 
времени появилась отметка о том, что в системе учёта заявок на доработку име- 
ется соответствующая ей задача (рис. 5.13). 
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Рис. 5.13 
Образовавшаяся связь между заявкой на доработку и точкой сохранения 


5.4. Выполнение заявки 


Первый верстальщик, которому менеджер поручил разобраться с пробле- 
мой, обновил свой рабочий каталог, убедился в том, что изображения действи- 
тельно не масштабируются, и принял заявку в работу. Последнее действие он 
отразил в системе учёта заявок следующим образом. Он открыл карточку заяв- 
ки, выбрал в меню пункт Едй и в открывшейся форме внёс два изменения: 

1) в поле За: установил значение Веме\м; 

2) в текстовом поле набрал сообщение: «Принял заявку в работу». 
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Затем сохранил внесённые изменения с помощью кнопок Рге\ем и Зибтй. 

После этого верстальщик приступил к выполнению заявки. Для того что- 
бы иллюстрации масштабировались вместе с изменением размера окна веб- 
браузера, он в файле таех.сз$ добавил правило М: 46% для селектора зес#оп 
119. Убедившись, что иллюстрации стали вести себя более рационально, он за- 
грузил выполненные изменения в репозиторий проекта с помощью команды: 


Ео$511 сопи1е -ш "задан масштаб для иллюстраций информационных блоков" 


В репозитории появилась точка сохранения с идентификатором 
ре461ебс61. Чтобы отчитаться о проделанной работе, верстальщик открыл в веб- 
браузере карточку заявки на доработку, перешёл в режим её редактирования и 
внёс следующие изменения: 

1) в поле Защ: установил значение Нхеа; 

2) в текстовом поле набрал сообщение: «Проблема устранена: 
[6е46ебс61 |». 

После того, как верстальщик сохранил внесённые в карточку изменения, 
система Розз автоматически добавила к точке сохранения отметку о том, что 
она появилась в результате решения проблемы, описанной в заявке с идентифи- 
катором 41а592еесо (рис. 5.14). Это произошло благодаря тому, что верстальщик 
в текстовом сообщении, дописанном к заявке, указал в квадратных скобках 
идентификатор точки сохранения. 


© тье эпае-раде меБзйе: СВЕ Х + > - * 
< СО Не защищено | *05$1.5егуег:8081 Лт) * © 
2020-03-22 ы 


18:41 Е = 
. Нхед иске! ЕЩЕ 75: Не масштабируются иплюстрации информационных блоков 
р!и$ 3 олег свапдез апИаа- 54175153е1 изег ое 


Сотех{ 


2020-03-22 


15:33 


задан масштаб для иллюстраций информационных блоков 
Геа! спеск-п: 5е467е6с61 изег. тро5е!1 {а95: соде 


2020-03-17 


14:44 


подключено фоновое изображение к заголовкам информационных блоков 
спеск-п: 1с568901а2 изег. \трозаг1 {а05; содержимое 


Рис. 5.14 
Привязка точки сохранения на шкале времени 
к ассоциированной с ней заявке на доработку 
Узнав о выполненной доработке, дизайнер обновил свой рабочий каталог 
(в результате этого получил изменённый файл таех.сз$), убедился в работоспо- 
собности веб-страницы и незамедлительно отразил свои впечатления в системе 
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учёта заявок. Для этого он открыл заявку для редактирования и внёс в неё сле- 
дующие изменения: 

1) в поле Защ: установил значение Тез{еа; 

2) в текстовом поле набрал сообщение: «Проверено. Всё работает». 

Заключительный шаг работы над заявкой выполнил менеджер. Он увидел, 
что автор заявки — дизайнер — удовлетворён тем, как её выполнил первый 
верстальщик, и изменил значение в поле Зав: на Созеч, т. е. закрыл заявку. 

А ещё, поскольку верстальщик записал проделанную работу в свою ветку 
репозитория (в рамках продолжения работы над содержимым веб-страницы), 
менеджер произвёл слияние этой ветки с основной ветвью проекта. И выполне- 
ние этой задачи ему упростило то, что верстальщик указал идентификатор точ- 
ки сохранения, куда записано решение проблемы, в комментарии к заявке на 
доработку: 

Еоз5$11 шекае ре46Еерс61 


При выполнении команды никаких проблем не возникло: 


Апбозупс: ВЕЕр: / /Марадег@Ео$5$11.зегуег:8081/ 

Воипа-Ег1рз: 1 АкЕ1Еасё5 зепёе: 0 геселуеа: 0 

Ра11 аопе, зепе: 476 гесезуеа: 453 1р: 192.168.56.101 

МЕВСЕ 1паех.с$$ 

"Ео5$11 ипао" 15$ ауа11аб1е 6о ипао сВапдез во ЕВе мокклпа сВесКоч®. 


Перед записью в репозиторий мгновенного снимка каталога, образовав- 
шегося в результате слияния ветвей, менеджер выяснил идентификатор заявки 
на доработку с помощью команды: 


Еозз11 Е1скее зВом 1 зеабаз=='С1озеа! 


В приведенной команде | — это номер отчёта о заявках. Перечень воз- 
можных отчётов можно получить с помощью команды Ю5$5$1 @скет 151 героц$. 

Завершается команда условием, которому должны удовлетворять отбира- 
емые в отчёт записи. В данном случае значение поля Заз (состояние) должно 
быть равно С!озе4 (Закрыт), т. е. будут отобраны только закрытые заявки на до- 
работку. Список полей, с которыми можно составлять условия, выводит коман- 
да 10551 Иске{ 151 Неа$. 

В результате выполнения команды на экран была выведена следующая 
информация: 
Басо1ок # шЕ1ше Еуре збабаз забзузеем &1Е1е 


#+с8с8с8 41а542еес0 2020-03-22 19:28:06 Ееабаге Веадиезе С1озеа Не 
масштабируются иллюстрации информационных блоков 


Здесь есть все сведения, которые присутствуют в таблице заявок, доступ- 
ной через веб-интерфейс, правда, в менее презентабельном виде, который огра- 
ничен изобразительными возможностями интерфейса командной строки. 

Идентификатор закрытой заявки в квадратных скобках менеджер указал в 
описании точки сохранения, которую создал в репозитории командой: 


Ео$$511 сопи16 -м "принято масштабирование иллюстраций по заявке 
[41а5а2еес0]" 
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На шкале времени появилась точка сохранения, в описании которой имеется 
гиперссылка, позволяющая быстро переключиться на просмотр заявки (рис. 5.15). 


© этьрЕ япае-раде \меБзйе: Ти" Хх о + 3 в > 
< - С О незащищено | 1055.5егуег:8081 Аитейте ж [= 
Зитре зте-раде меБзНе / птеме в» | 
— Ноте Титейпе Ее5 Вгапсвез 
Адуапсед |Модет Мем т] Мах|50 _ || Спескиь " 
39 снеск-тз 
2020-03-23 
09:57 
2020-03-22 
15:33 


Рис. 5.15 


Переключение с описания точки сохранения на карточку заявки 
Кроме того, она попала в список точек сохранения, ассоциированных с 
заявкой на доработку, который можно посмотреть с помощью пункта Снеск-тз 
горизонтального меню карточки заявки (рис. 5.16). 


© то эпае-раде мебзйе: Ме хо + 


< -> С О не защищено | 105$й.5егиег 8081 Ипо/41а5а2еес0 # а 


зитре эта е-раде меь$Ке / мем пскено 


= Ноте Титейпе Ре5 Вгапсвез 


ЕЗИ Нюлу М ем Тске!  Раймех — Ттешпе 


Пске ОУЮ: | @ 41а592еес0!За7сЗа26а0е4а64535642аке7а9с 


Тие: Не масштабируются иллюстрации информационных блоков + 


Год 
= Ноте Титейпе Ре5 Вгапспез 


Ныюгу Заз Титейое 


2020-03-23 


— ни 


Рис. 5.16 
Просмотр точек сохранения, относящихся к заявке на доработку 
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В рассмотренном примере заявка на доработку последовательно побывала 
в состояниях: «создана», «на рассмотрении», «выполнена», «проверена» и, 
наконец, «закрыта». Проследить всю историю этих изменений можно на шкале 
времени, которая открывается с помощью пункта Тите!тпе горизонтального ме- 
ню, присутствующего на карточке заявки (рис. 5.17). Идентификатор заявки за- 
чёркнут, потому что она находится в состоянии «закрыта». 


— | х 
© тре эпав-раде змеБзйе: Ме. Хх ++ 


— С © Не защищено | +055Й.5егуег:8081 АКблем/?пате=41а592еес0 ж = 


Зипр/е зта!е-раде меб зНе / меток: мыши 1 9 


— Ноте ТПтейпе Ее; Вгапсве$ Озегз 


АНасй Спеск-т5 ЕЗИ Ногу Мем ТисКе! Р!аймех! 


ске! ЧО: № 41а592еес0!За7сЗа25а0е4а54535642асе7а9с 


Те: Не масштабируются иллюстрации информационных блоков 


Свеск-т$ Ногу Заи$ 


2020-03-22 
19:28 

. С1озед иске! Н+а582ее=8}: Не масштабируются иплюстрации информационных блоков 

р! 2 оег спапдез 


а|ПНасЕ её 5сс39553 изег. Мападег 


19:25 

:- * Тез ед иске! {458 2ее=8} аййасЕ 159с750е13 изег. Оезюпег 
18:41 > 

ы * Рхед иске {аб 2еее8} апиасеЕ 64115153е1 изег. |трозег1 

18:24 
‚ Кемеми НсКЕ! Ма? еее}. аПИасЕ За774еде!4 изег. итрозе!1 

17:34 
 Уепйе4 #сКе! {44258 2ее= 6} апИасЕ сседае5 19 изег. Мападег 

2020-03-21 

18:12 
. Ада ацасбтеп! {гоцЫе.рпа 0 иске! 4+а582еее8} апИасЕ 4750466138 изег: Мападег 

12:28 


. Меми иске! {44+а582ее=8} Не масштабируются иллюстрации информационных блоков 


ацйасЕ 712000916 изег. Оезюпег 


Рис. 5.17 
Шкала времени заявки на доработку 
Эти же сведения можно получить с помощью команды: 
Ео$511 Е1скее р156огу 41а5а2еес0 


По мере смены состояний менялся соответствующий заявке цвет строки в 
таблице заявок (рис. 5.18). При активной работе над проектом, когда в системе 
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зарегистрировано одновременно множество заявок, это помогает быстро оце- 
нить общую картину. 


© тре зтаЕ-раде мебзйе: АИ + 


< С © не защищено | 10$51.5егуег8081/гралем?т=1 х ©@ 


эитр!е зэтае-раде меь$Ке / литекеьь оеноль — подом 


= Ноте тете ЕИез Вгапсвез 


М ем Пске! м ОЕ 


ли 


Кеу: Асме КВемем Рхеб Темед  ОБеепебв —С105е9 


ВАХ 


тёте + Туре + {ати + зиозу${ет + 11 + + 
41а592еес0 2020-03-22 Реа\иге_Вециез! — С1ю05ед Не масштабируются иллюстрации вби 
19:28:06 информационных блоков 
7236996579 2020-03-23 Соде_Оеем Ахед Увеличить отступ между текстом и вби 
21:02:40 заголовком 
273691713а — 2020-03-23 Реа\иге_Ведиез! — Ое?етед Реапизовать разаорачивающееся ей 
21:03:56 меню 
41903408ее 2020-03-23 Соде_Веес Ореп Привести в соответствие с макетом еб 
21:17:03 шрифт заголовка странички 
Рис. 5.18 


Цветовое кодирование этапов обработки заявок 
Строки таблицы можно сортировать по значениям, находящимся в колон- 
ках, если щёлкнуть по ромбу, изображённому справа от заголовка соответству- 
ющей колонки. В результате сортировки ромб заменится на изображение стрел- 
ки вверх или вниз в зависимости от установившегося порядка. 
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Глава 6 . 
СИСТЕМА ОПОВЕЩЕНИИ 


6.1. Уведомления о событиях 


После ознакомления с порядком взаимодействия участников проекта при 
обслуживании заявок на доработку может возникнуть вопрос: а как пользовате- 
ли будут узнавать об изменении состояния заявки, которая их интересует? 
В дальнейшем будут рассмотрены другие подсистемы Е о$$1, в частности — си- 
стема документирования и форум, которым тоже придётся уделять внимание. 
Кроме того, нужно постоянно быть в курсе последних событий, происходящих 
в ядре системы Ео5$ — репозитории разрабатываемого проекта. 

Ответить на поставленный вопрос можно в административном стиле — 
рекомендовать участникам проекта периодически обращаться к веб-интерфейсу 
этих подсистем, чтобы узнавать о происходящих в них событиях. Однако это 
приведёт к непроизводительным затратам времени, снижению продуктивности 
разработчиков и может даже вызвать сомнения в целесообразности использова- 
ния всех перечисленных инструментов. Поэтому хотелось бы найти более удоб- 
ное решение для распространения новостей. 

В системе ЕРоззЙ реализован механизм, который позволяет оперативно 
информировать участников проекта о происходящих в ней событиях. Уведомле- 
ния о новостях формируются в формате сообщений электронной почты, кото- 
рый подробно описан в документе ВЕС 822. Из системы Е0$$1 эти уведомления 
могут передаваться во внешнюю среду одним из следующих способов: 

® на стандартный вход указанной в настройках утилиты (как правило, 
программы зепатай); 

® путём записи в базу данных ЗОГ1е; 

® выгружать заданный каталог в виде отдельных файлов; 

® отправляться на почтовый сервер по протоколу ЗМТР; 

® передаваться по протоколу ЗМТР непосредственно адресатам. 

Участники проекта наверняка общаются между собой по электронной по- 
чте, поэтому вариант передачи уведомлений Е0$5Й через почтовый сервер вы- 
глядит наиболее привлекательным. Но реальность такова, что популярные пуб- 
личные сервисы электронной почты вынуждены устанавливать барьеры на воз- 
можность использования их в качестве ретрансляторов в целях борьбы со 
спамом — потоком нежелательной корреспонденции. В настоящее время систе- 
ма Роз не поддерживает авторизацию при работе по протоколу ЗМТР, что ещё 
больше снижает её шансы на использование совместно с внешними системами. 
Другими словами, отправлять письма напрямую на почтовые адреса в доменах 
тай.ти или эта|.сот не получится. 

Но если электронная почта разработчиков обслуживается их собственным 
внутренним сервером, то он может быть сконфигурирован с более мягкими тре- 
бованиями к безопасности, что позволит ему принимать подключения от серве- 
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ра Еоз$1 по протоколу ЗМТР. В этом случае его защита от несанкционированно- 
го использования должна быть реализована другими средствами, например с 
помощью брандмауэра. Ввиду разнообразия программных продуктов, которые 
могут использоваться для построения почтовой системы организации, настрой- 
ка самого почтового сервера здесь не освещается. Она должна производиться в 
соответствии с документацией на почтовый сервер. 

Ниже рассматривается настройка системы Ео$$Й для рассылки оповеще- 
ний через внутренний почтовый сервер коллектива разработчиков по протоколу 
УМТР. 


6.2. Настройка рассылки оповещений 


Если решено внедрить информирование по электронной почте с исполь- 
зованием протокола ЗМТР, то первое, что надо сделать, — это проверить, смо- 
жет ли сервер Ео$5Й взаимодействовать с почтовым сервером. Для этого на сер- 
вере Ео$51 надо ввести команду: 


Ео$$511 сезе-зшер-ргоре --91хесЕ ша11.зекгуег погер1у@Ео$$11.зегуекг 
В приведенной команде тай.зегиег — это сетевое имя почтового сервера 
(вместо него можно указать [Р-адрес). В случае успешного прохождения про- 


верки на экране должны появиться строки информационного обмена с почто- 
вым сервером по протоколу ЭМТР: 


СоппесЕ1опл о "ма11.зекуег" 5: 220 192.168.56.1 ЕЗМТР ЗаБЕЕВабМТР па11 


С: ЕНГО погер1у@Ео$$11.зехуех 
3:.-250=192.168.56.1 

5: 250-8ВТТМТМЕ 

5: 250-АОТН ТОСТМ 

5: 250 ОК 

С: ООТТ 

5: 221 Вуе 


Возможно, вместо этого через некоторое время после запуска команды на 
экране появится единственная строка: 


саппоЕ соппесЕ Фо Бозе ма11.зехуег:25 


Это означает, что Ео5$1 не смог подключиться к ТСР-порту номер 25 поч- 
тового сервера тай.зегуег. Возможно, дело в настройках брандмауэра одного 
или обоих серверов. В любом случае, речь идёт о невозможности сетевого под- 
ключения. 

Может получиться так, что после запуска команды на экране появятся 
следующие сообщения: 

СоппесЕ1оп Ко "ма11.зегуег" 
5: 

Э 

Еггог: Е1теоцЕ 


К сожалению, это свидетельствует о неспособности используемой версии 
Ео51 взаимодействовать с почтовым сервером по протоколу ЗМТР. Такое пока 
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что происходит на операционных системах \т4о\з и Миих. Скорее всего, эта 
проблема будет в скором времени решена, возможно, даже с помощью читате- 
лей этой книги. А пока что можно констатировать, что Ео$$1 2.8 в операцион- 
ной системе Магаа ОМОЛлпих 7.1 с почтовым сервером работает правильно. 
Вероятно, не возникнет проблем и на других версиях Глпих. 

Будем считать, что проверка подключения к ЗМТР-серверу завершилась 
успешно. Тогда можно перейти к настройке сервера Еоз$1. Для этого надо зайти 
в веб-интерфейс Роз и авторизоваться пользователем с правами владельца ре- 
позитория (прав администратора недостаточно). Затем следует выбрать пункт 
меню Аадти | Моййсайоп (рис. 6.1). 


= О х 
© тре этае-раде меБзИе: бег Х + 
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Рис. 6.1 
Переход к форме настройки оповещений по электронной почте 

Откроется форма настройки оповещений по электронной почте, в которой 
надо заполнить следующие поля (рис. 6.2): 

® Сапопса! Зегуег ЦАЁЕ (базовый адрес сервера для использования в 
ОВГ)) — адрес сервера Ео$$1, с которого будут начинаться ссылки в оповещени- 
ях. Например, если указать в этом поле значение И#р:/Мо$$1.зегуег:8081, то в опо- 
вещении о заявке с идентификатором 41а592еес0 ссылка на заявку будет запи- 
сана в виде ПИр:/Ло$$1.зегуег:8081АК\Мем/?пате=41а592еесо; 

® "Веит-Ра!" етай ад9гез$ — обратный адрес для указания в уведомле- 
ниях; 

® Нерозйогу №МсКпате (псевдоним репозитория) — короткое название ре- 
позитория для указания в теме письма, например $$р-мебзйе; 
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® Етай Зепа Метод (способ отправки электронной почты) — для рас- 
сматриваемого примера, когда сообщение подлежит пересылке на ЗМТР- 
сервер, надо выбрать из списка значение ЗМТР геау. Но возможны и другие ва- 
рианты: 

— Рре №0 а соттапа — сообщение передаётся на стандартный вход ука- 
занной в отдельном поле утилиты командной строки (обычно используется 
зепдтай); 

— Зюге п а ЧайаБазе — сообщения записываются в указанную в отдельном 
поле базу данных ЗОГ\е; 

— Эюге т а аиесюогу — сообщения записываются в файлы по указанному в 
отдельном поле пути; 

® ЭМТР геау Поз — адрес сервера электронной почты. Например, 
тай.зегуег. По умолчанию будет использоваться стандартный ТСР-порт для 
протокола ЗМТР номер 25, но при необходимости номер порта можно явно за- 
дать через двоеточие после имени сервера; 

® Адтиигаюг етай аЧаге$$ — адрес электронной почты администратора 
сервера, на который будут отправляться сообщения о технических проблемах. 
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Рис. 6.2 


Настройка оповещений по электронной почте 
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После заполнения всех полей надо нажать кнопку Арру СПапдез, которая 
продублирована вверху и внизу формы, дважды. После этого в заголовке формы 
появится текст: Зам Ощодотд Етай: Ве!ау 1ю тай.зегуег изтд ЗМТР (Состояние 
исходящей почты: Пересылка на сервер та!.зегуег с использованием ЗМТР). 

Посмотреть актуальные настройки системы рассылки оповещений можно 
с помощью команды: 


Еоз511 а1екЕз$ зеёЕ1па$ -В ззрмерз16е.Ео$511 
Поскольку ЭТИ настройки выполняются и хранятся только в сетевом репо- 

зитории, команду нужно выполнять непосредственно на сервере Еоз$1. С по- 
мощью параметра -Кв команде указывается путь к файлу сетевого репозитория. 
После выполнения настроек через веб-интерфейс, как было только что рассмот- 
рено, команда выведет на экран следующие сведения: 

ета11-5е1Е (1оса1) Боипсе$@Ео$$11.зекуек 

ета11-зепа-сомтапа 

ета11-зепа-аь 

ета11-зепа-а1х 

ета11-зепа-пефброЯ (1оса1) ге1ау 

па11-зепа-хе1аубозе (1оса1) та11.зехуег 


При необходимости значения выведенных полей можно изменить из ко- 
мандной строки, но тоже только на сервере. Например, если почтовый сервер 
ожидает подключений на ТСР-порту номер 2525, то можно ввести команду: 


05511 а1ех®5 зеЕЕ1па5 ета11-зепЧ-ге1ауВо$е ма11.5ек\уех:2525 -В 
ззрмерз1ее. Ео$$11 


Теперь можно проверить, как работает система оповещений по электронной 
почте, отправив тестовое сообщение одному из участников проекта. Пусть это бу- 
дет дизайнер. Для этого прямо на форме настройки оповещений в дополнительном 
горизонтальном меню надо воспользоваться пунктом Зепа Аппоипсетет, после че- 
го заполнить конверт письма и нажать кнопку Зепа Меззаде (рис. 6.3). 
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Рис. 6.3 
Отправка тестового сообщения 
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Если система работает правильно, то через несколько секунд дизайнер 
сможет прочитать отправленное ему сообщение (рис. 6.4). 


Почта — О х 
$зр-меЬзЩе Тез поНЯсаНоп 


о Боипсез@!о5$Й.5егуег <Боипсез@о5$Й.зегмег> 
11:17 


Кому: дезюпег@юо5$й.егуег 


Это - тестовое сообщение 


Рис. 6.4 
Полученное тестовое сообщение 


6.3. Подписка на оповещения 


Итак, система оповещений по электронной почте настроена и проверена. 
Но чтобы получать такие оповещения, участники проекта должны попасть в 
число подписчиков. Сделать это можно двумя способами. 

Во-первых, сделать пользователя Е05$ подписчиком может владелец или 
администратор репозитория. Если первому достаточно воспользоваться пунк- 
том меню Ада Мем Зибзспйрег (Добавить нового подписчика) на недавно рас- 
смотренной форме настройки системы рассылки, то администратору потребует- 
ся перейти на форму настройки почтовых рассылок посредством пункта рас- 
крывающегося меню Ёодощ | Ета! Аеп$ или путём ввода в адресной строке веб- 
браузера: ПНр:/Моз$й.зегуег:8081/зиБзспбе (рис. 6.5). 
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Рис. 6.5 
Переход к настройке почтовых рассылок 
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В форме добавления подписчика понадобится заполнить поля Етай 
Адагезз: (Адрес электронной почты) и Цзег: (Пользователь) (рис. 6.6). Значения 
в этих полях не обязательно должны соответствовать указанным в учётных за- 
писях пользователей Ео$$1. Однако если указать имя несуществующего пользо- 
вателя, то он не сможет пройти проверку адреса электронной почты, о которой 
говорится ниже. 

Затем надо отметить категории сущностей Роз, о которых должны от- 
правляться уведомления: 

® Аппоипсетет — анонсы; 

® Спеск-тз — точки сохранения в репозитории; 

® Гогит Роз{5 — сообщения на форуме; 

® ТсКе! спапдез — изменения заявок на доработку; 

® \\К! — документация. 

Далее надо выбрать один из двух способов информирования: п@Маиа! 
Етай$ (Индивидуальные письма) или Байу Оез{ (Ежедневная рассылка). 
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Рис. 6.6 
Добавление пользователя в перечень подписчиков 
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Кроме этого, на форме присутствуют ещё два флажка в группе Адтт 
Орйопз: (Опции администрирования): \еййеа (Проверен) и Во по! са! (Не рассы- 
лать). Первый флажок в итоге будет установлен независимо от того, как была 
заполнена форма. А установка второго флажка означает, что рассылка этому 
пользователю не должна отправляться до того момента, пока этот флажок не бу- 
дет снят. 

По завершении заполнения формы надо нажать кнопку Зибтй (Подтвер- 
дить). На экране отобразится форма редактирования учётной записи только что 
созданного подписчика. На этом этапе подписчик уже добавлен в список, в чём 
можно убедиться, воспользовавшись пунктом дополнительного меню 1$ 
Зибзсирегз. 

Единственное, на чём стоит задержать внимание, — уже упомянутый 
флажок Ует#ед. На открывшейся форме он будет установлен, и сейчас админи- 
стратору предоставляется возможность его снять. Если флажок отсутствует, то 
будет считаться, что адрес электронной почты, указанный в форме подписки, 
нуждается в проверке. Механизм проверки заключается в том, что рассылка на 
такой адрес не будет производиться до тех пор, пока пользователь, которому 
назначена подписка, не авторизуется в системе Роз и не зайдёт на страницу 
настройки своей подписки. Лишь после этого учётная запись подписчика акти- 
вируется, о чём ему сообщит надпись: \оцг етай аей зибзсирНоп Ваз Бееп уеййеа! 
(Ваша подписка на уведомления прошла проверку!). 

Теперь должно быть понятно, что если у пользователя нет учётной записи 
Ео5$ или разрешения на самостоятельное управление подписками, о котором 
будет сказано ниже, то он не сможет подтвердить подписку, оформленную на 
него администратором. Поэтому для таких пользователей администратор не 
должен убирать флажок \епйеч, если он не хочет воспрепятствовать получению 
ими уведомлений. 

Преимущество создания подписчика владельцем или администратором 
репозитория Е0о$$1 заключается в том, что таким способом подписку на уведом- 
ления можно оформить не только на участника проекта, но и на любого другого 
человека, имеющего учётную запись на сервере электронной почты. Например, 
это может быть директор организации, который не участвует напрямую в работе 
над проектом, но желает отслеживать через получение рассылок активность 
своих сотрудников. 

Второй способ оформления подписки на уведомления Е05$ — участни- 
ком проекта самостоятельно. Он доступен только в том случае, если в настрой- 
ках учётной записи пользователя администратором установлена отметка Етай 
Аейз (Почтовые уведомления) (рис. 6.7). 

Пользователи, имеющие разрешение на управление своими подписками, 
после авторизации в Ео$51] получают возможность произвести их настройку, пе- 
рейдя по гиперссылке Етай Аей$ с экрана выхода из системы 090 (рис. 6.8) 
или по ссылке ПЯр:/Мо$$1.зегуег:8081/а!еп$. 
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Рис. 6.7 
Разрешение на самостоятельное управление подписками 
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Рис. 6.8 
Ссылка на настройку почтовых рассылок 
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Форма, которая предлагается к заполнению пользователю, является со- 
кращённым аналогом рассмотренной выше формы, заполняемой администрато- 
ром Еоз$И. На ней имеется только поле Ета! Адагезз: для указания адреса элек- 
тронной почты, куда должны отправляться сообщения, группа флажков Торсз: с 
возможностью выбора категорий сообщений и поле со списком ОБей\уету:, позво- 
ляющее указать способ отправки сообщений (отдельными письмами или еже- 
дневным отчётом). Учётная запись подписчика, который подписался самостоя- 
тельно, сразу становится активной. 

Если у пользователя имеется разрешение на самостоятельное управление 
подписками, то, независимо от того, был он подписан на уведомления Е 0551 ад- 
министратором или подписался на них самостоятельно, он может отказаться от 
подписки. Для этого на форме управления подписками надо нажать кнопку 
Упзибзсий6е (Отписаться), потом установить флажок в появившемся поле \егу: 
Упзибзсйе (Проверка: отписаться) и ещё раз нажать кнопку Упзибзсибе. 

Каким бы способом ни были оформлены подписки на оповещения, все 
подписчики попадают в единый список, который доступен администратору Еоз$1 
через пункт меню 14$ Зибзсибег$ или по ссылке ПЁр:/Мо$$1.зегуег:8081/зибзсирег®. 
Он отображается в виде таблицы, изображённой на рисунке 6.9. 


[<>] зитр/е 5та!е-раде меб Не; /ре Х -- г. е > В 
< - С О незащищено | юззй.5егуег:8081/аем$ * о 
Зипр!е зтае-раде меь$Ке / чразе зивзсириоп 
Мападег — 1одо\! 
= Ноте Титенпе Е|е$ Вгапспез Озегз 
АЗд Ме\ми Зибзспбег 
Етай + |Емеп!з +|О!ез1-Оту? +| Цзег + |Мей Мея? +|Газ! сКапае ||Сгеаиед + 
агесог@/юо$$И.зегиег |асй\м 9'9ез{ Ойесюг |репдта 3.0 Почцгз 2020-03-29] 
дезюпег@юз$1.зегуег|асЯм Пезодпег |уез 3.0 Почг; 2020-03-29] 
ипр2@!о$эй-зегуег __||ас\м \прозег2 |уез 3.0 Почгз 2020-03-29] 
ипр1@!о55й-зегуег __ ||ас\ |трозег1 |репдпа 23.1 поигз 2020-03-28] 
пог@!ю$51.зегуег асй\м 419ез{ Мападег |уез 23.1 поигз 2020-03-28] 
Рис. 6.9 


Перечень подписчиков 
В первой колонке Етай таблицы отображаются адреса электронной по- 
чты, на которые оформлены подписки. Они являются гиперссылками, при пере- 
ходе по которым открывается форма для редактирования соответствующей под- 
писки. 
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Во второй колонке Еует$ в закодированном виде отображаются наборы 
событий, на которые генерируются оповещения. Каждому событию соответ- 
ствует буква латинского алфавита: 

(а)ппоипсе — анонсы; 

(с)песк-т — точки сохранения в репозитории; 
(Рогит — сообщения на форуме; 

(!ске! — заявки на доработку; 

(м! — страницы документации. 

В третьей колонке О!дезНОпту отображаются способы доставки оповеще- 
ний: индивидуальными письмами (пустая ячейка таблицы) или ежедневными 
подборками (49е$0. 

В четвёртой колонке Узег отображаются имена пользователей Е0о$$1|, на 
которых оформлена подписка. 

В пятой колонке Уе#ед отображаются признаки того, что адрес электрон- 
ной почты подтверждён (уепйед) или ещё находится в ожидании подтверждения 
(репатод). 

В шестой колонке Ёа${ Спапде и в седьмой колонке Стежеа отображается 
информация о времени последней модификации и дате создания подписки со- 
ответственно. 


6.4. Система в действии 


Рассылкой сообщений занимается сервер Ео$$1. События, о которых сле- 
дует уведомить подписчиков, накапливаются в базе данных и находятся там в 
ожидании обработки. 

Обработка ожидающих событий производится подсистемой БаскоЁйсе, 
которая активируется запросами, поступающими от пользователей Ео$$1. 
Например, когда кто-то записывает моментальный снимок рабочего каталога в 
репозиторий, одновременно с созданием точки сохранения запускается процесс, 
обслуживающий фоновые задачи. В число таких задач входит и рассылка уве- 
домлений. 

Такой принцип выполнения фоновых задач не требует наличия постоянно 
активного серверного процесса, однако для его нормального функционирования 
запросы в систему Ео5$Й должны поступать достаточно регулярно. Если ника- 
ких действий с репозиторием не происходит, то не будут выполняться фоновые 
задачи, а значит, задержится и обработка ожидающих событий с рассылкой уве- 
домлений. 

Администратор может посмотреть состояние системы оповещений через 
пункт раскрывающегося меню Аати\гайоп радез | Заз. Помимо подробной ин- 
формации о репозитории в нижней части открывшегося окна находятся поля, 
имеющие непосредственное отношение к рассматриваемому вопросу (рис. 6.10): 

® ВаскоМсе — время последнего запуска фоновых процессов; 

® Ошдотд Етай (Исходящая почта) — способ осуществления рассылки 
уведомлений; 
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® Репатд Аей$ (Ожидающие уведомления) — количество записей о со- 
бытиях, которые ожидают обработки, отдельно — индивидуальными письмами 


(погта!) и отдельно — 


® Зибзспрегз (Подписчики) — количество подписчиков, 


ежедневными подборками (44е51); 
отдельно — 


участвующих в получении уведомлений (асй\е), и отдельно — всего, вместе с 
теми, у кого отключено получение оповещений (1ю1а|). 


© тре зтае-раде мебзИе: Вер Х 


— С О Ннезащищено 


= Ноте 


Асйуйу Верой$ АПНас!5 
ВерозНогу $1те: 

МитБег О{ АМНас!з: 
Упсотргеззеа АМНас! $12е: 
Сотргеззюоп Вано: 
МитБег О{ СпескК-т$: 
Митьег О РЙез: 

Митьег О{ УМК! Радез: 
МитьБег О? ТсКе!з: 

МитьЬег ОЁ Рогит Роз1{5: 
ОигаНоп О} Рго]ес": 

Рго]ес! 10: 

Роззй Уег®1оп: 

$@Ёе Уегзюп: 

$спета Уег®!оп: 

ВерозЙогу Кеш: 
Оа{аБазе $1213: 

Васко се: 

Ошдотя Етай: 


Репатя А!етз: 
ЗибзспБегз: 


тре зэтае-раде мерз$Ке / веро-иогу занзйсь мапаре подом 


тете 


Епмгоптеп{ 


— О х 
+ 


{0551.5егуег:8081 /тат 


х @ 


5 Вгапспез Узегз 


Назй Созюп$ Зспета ТаЫе Зез ОВЕ$ \МеБ-Саспе 
602,112 Буе$ 

105 (65 АИКех{ апа 40 деказ) е{ай5 

3,096 Буез$ ауегаде, 248,628 Буе$ тах, 325,142 {о{а! 

5:10 

38 

8 

0 

1 

З оп 1 {геа45 

30 дау$ ог арргохитаеу 0.08 уеагз 
53е4е14452а7289е61а337се1с{8с9а9917686 Эитр!е зтае-раде мебзйе 
2019-10-04 21:41:13 [999е182234] (2.10) (4е{а!з) 

2019-10-04 15:03:17 [с20а353364] (3.30.0) (де{а!з) 

2015-01-24, зВа3 

2020-02-29 07:24:50 Ву Розз1 2.9 [01979а3е09] 2019-07-13 13:05:19 УТС 
147 радез, 4096 Буез/раде, 0 ее радез, УТЕ-8, деве тоде 

Газ{ гип: 2.1 Воугз адо 

Ве!ау {0 тай.егуег изта ЗМТР 

7 попта!, 8 91де= 

3 асвуе, 5 10а! 


Рис. 6.10 


Просмотр состояния системы оповещений через веб-интерфейс 


Эти же сведения можно получить с помощью запроса, выполненного к 


файлу сетевого репозитория: 


Ео$$11 а1екЕз збабаз -В ззрмерз16е.Ео$$11 


Приведенная команда выведет информацию о настройках системы рас- 


СЫЛКИ уведомлений и её текущем состоянии: 


(1оса1) 
ета11-зеп-соммапа 


ета11-зе1 Е роппсез@Ео$$11.зекуег 
епа11-зепа-аь 
епта11-зепа-а1к 
па11-зепа-меевоа 


(1оса1) ге1ау 
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ета11-зепа-ге1аубозе (1оса1) пма11.зегуегк 
репа1п9-а1егф$ 7 

репа1п9-91де5Е-а1ехез$ 8 
фоЕа1-зирзск1рег$ 5 

асЕ1уе-зирзск1Ьег$ 3 


В рассматриваемом примере в системе рассылки накопилось 15 уведом- 
лений: семь для отправки индивидуальными сообщениями и восемь — для 
ежедневной рассылки. Чтобы не дожидаться, когда их отправит фоновый про- 
цесс, можно дать команду: 


Ео$$11 а1екЕз зепа -В ззрмерз16е.Ео$$11 


Эта команда отправит только индивидуальные сообщения. Для отправки 
писем с ежедневными рассылками в неё надо добавить параметр --@8е51. 

Если репозиторий используется не очень интенсивно, приведенную ко- 
манду можно задействовать в автоматически выполняемых сценариях для регу- 
лярной рассылки уведомлений. 
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Глава 7 
СИСТЕМА ДОКУМЕНТИРОВАНИЯ 


7.1. Программные документы 


Документация является неотъемлемой частью программных проектов. 
Важность этого компонента подчёркивается наличием отдельнй группы стан- 
дартов, посвящённых документации, — ГОСТ 19 ЕСПД (Единая система про- 
граммной документации). Многие стандарты этой группы были разработаны 
ещё в 1970-х гг. и в своём большинстве по сегодняшний день не утратили акту- 
альности. В соответствии со стандартом к программным относят документы, 
содержащие сведения, необходимые для разработки, изготовления, сопровож- 
дения и эксплуатации программ. 

Почему документация, или всестороннее техническое описание програм- 
мы, так важна? Документально зафиксированные требования исключают неод- 
нозначности и вариации в их трактовке, описания различных аспектов реализа- 
ции и функционирования упрощают последующую модификацию, предотвра- 
щают ошибки на этапах внедрения и эксплуатации. 

С перечнем рекомендуемых стандартом сопроводительных документов 
можно ознакомиться в ГОСТ 19.101-77, который описывает целых 16 их видов. 
Это — исчерпывающий список, и не каждая разработка нуждается в полном 
наборе документов. В то же время каждый этап разработки программного про- 
дукта должен документироваться. 

В жизненном цикле компьютерной программы можно выделить четыре 
основные фазы: 

® проектирование; 

® реализация; 

® внедрение; 

® эксплуатация. 

Проектирование начинается с составления технического задания, в кото- 
ром описываются цели проекта и основные требования к разрабатываемому 
продукту. На основе технического задания разрабатывается детальная специфи- 
кация, включающая перечень компонентов, которые необходимо реализовать, и 
описание способа их взаимодействия в создаваемой системе. Желательно сразу 
описать и методику испытаний разрабатываемого продукта, которая позволит 
понять, что поставленные перед проектом цели достигнуты и программа соот- 
ветствует предъявляемым к ней требованиям. 

На стадии проектирования документы создаются при активном участии 
как разработчика, так и заказчика, а результат их совместной работы должен 
быть утверждён обеими сторонами. Важно, чтобы эти документы были макси- 
мально конкретными. Не следует пытаться обойтись в них общими фразами и 
сглаживать острые углы. Детальные перечни функций, подробное описание ва- 
риантов использования, конкретные значения основных параметров уменьшат 
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количество вопросов на этапе реализации и исключат конфликты на этапе при- 
ёмки готового продукта. 

На основе технического задания и спецификации выполняется разработка 
программы — наступает этап реализации. Основным документом этого этапа 
станет текст программы на языке программирования. Однако, несмотря на его 
исчерпывающее содержание, опытные программисты подтвердят, что пользо- 
ваться им без вспомогательных материалов не всегда легко. Следование согла- 
шениям по оформлению текстов программ может сгладить проблему, но не ре- 
шает её полностью. Большим подспорьем к пониманию программы являются 
внедрённые в её текст комментарии. 

Не следует забывать, что текст программы — это ещё далеко не сама про- 
грамма. А процедура превращения исходных текстов в исполняемый код может 
оказаться нетривиальной задачей. Поэтому необходимо подробно описать про- 
цесс сборки: какие инструменты, с какими параметрами и в какой последова- 
тельности для этого применяются, как выполняется проверка правильности 
программы, получившейся в результате этого процесса. 

Одновременно с написанием текста программы полезно фиксировать 
описания реализуемых алгоритмов, объяснять, почему было выбрано то, а не 
иное решение. На этом же этапе надо разрабатывать и документы для тех, кто 
будет готовить создаваемую систему к эксплуатации, и тех, кто ею будет поль- 
зоваться. Тогда к моменту наступления очередных этапов — внедрения и экс- 
плуатации — информационное обеспечение в виде руководств оператора и 
пользователя будет уже подготовлено. По большому счёту, эту книгу можно 
считать руководством пользователя и руководством оператора системы Е0$$1. 

На практике программа используется не бесконечно, а до определённого 
момента — пока не утратят актуальности выполняемые ею функции и пока бу- 
дет существовать возможность её адаптации к изменяющимся внешним услови- 
ям. Этот момент обычно не показывается на формальной схеме жизненного 
цикла, потому что его наступление не всегда можно предсказать, а тем более 
нелегко описать действия, которые должны ему сопутствовать. 

Как правило, выводимую из эксплуатации программу сменяет другая. Ка- 
кое-то время в эксплуатации могут находиться обе системы — старая и новая 
(для новой системы этот этап называется опытно-промышленной эксплуатаци- 
ей). Такой подход позволяет сравнить результаты работы двух систем и при 
необходимости внести исправления в новую систему. Обычно при переходе вы- 
полняется перенос данных из старой системы в новую. В любом случае надо 
выполнить архивирование данных, накопленных в старой системе, и организо- 
вать их хранение вместе с программным окружением, чтобы при необходимо- 
сти можно было получить к ним доступ. 

Программную документацию можно разделить на два класса — формаль- 
ную и неформальную. Формальная документация должна быть разработана и 
включена в комплект поставки программного продукта независимо от желания 
разработчиков. Те документы, которые перечислены в стандартах, являются ча- 
стями формальной документации. 
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Но для накопления и сохранения знаний о разрабатываемой системе, ко- 
торые зачастую возникают непосредственно в ходе работы над проектом, разра- 
ботчики ведут собственные записи. Это могут быть заметки и наброски в тетра- 
ди, ежедневнике или даже на отдельных листках. Такая информация относится 
к неформальной документации. Несмотря на то, что она не всегда хорошо 
структурирована и оформлена, содержащиеся в ней сведения могут составлять 
высокую ценность для проекта. 

Подсистема Роз$П УИ представляет собой набор взаимосвязанных веб- 
страниц, хранящихся в репозитории вместе с файлами разрабатываемого проек- 
та, и хорошо подходит для ведения неформальной документации. 


7.2. Оформление текстов 


Текст плохо читается, если его оформлению не было уделено должного 
внимания. Правила пунктуации русского языка описывают давно вошедшие в 
привычку обозначения, позволяющие разделять слова (пробелы), предложения 
(точки), выделять прямую речь (кавычки) и обозначать другие структурные 
элементы текста. Таким образом, пунктуация — это универсальный язык раз- 
метки, пригодный для использования как в рукописном, так и в печатном тек- 
сте. 

В настоящее время практически на любом персональном компьютере 
установлен визуальный текстовый процессор типа М1сгозой \Уог4 или 
ГабтеОйсе Утиег — если не для подготовки документов, то для их просмотра и 
печати. Программы этого типа помимо самого текстового содержания докумен- 
та отображают и позволяют изменять его оформление — размер и толщину 
шрифта, цвет символов и фона, способ выравнивания абзацев, величины отсту- 
пов и интервалов. Стили оформления применяются к тексту сразу в ходе редак- 
тирования, в результате чего он всегда выглядит нарядным. 

Но текстовые процессоры устроены таким образом, что оформление 
накладывается на текст путём выделения участков текста и выбора для них не- 
обходимых свойств из палитры цветов или списка шрифтов. Результат выбора 
сохраняется вместе с текстовым содержанием в файле, структура которого 
больше напоминает базу данных, чем файл с простым текстом. Изменить стиле- 
вое оформление путём отыскания в этом файле необходимых элементов и их 
корректировки практически невозможно. 

Простые текстовые редакторы отличаются от визуальных текстовых про- 
цессоров тем, что позволяют создавать файлы, содержащие только набираемые 
на клавиатуре символы. Этого достаточно, чтобы создавать тексты программ. 
Более того, в текстах программ недопустимо присутствие посторонней инфор- 
мации об оформлении текста. Как правило, параметры отображения устанавли- 
ваются в настройках текстовых редакторов и применяются ко всему редактиру- 
емому документу целиком. 

Однако программисты предпочитают использовать не простые текстовые 
редакторы, а так называемые редакторы с подсветкой синтаксиса. Они отлича- 
ются тем, что умеют распознавать синтаксические конструкции языка програм- 
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мирования, такие как заголовки функций, комментарии и литеральные констан- 
ты, и выделяют их из остального текста цветом или начертанием символов. Это 
позволяет лучше ориентироваться в тексте программы, легче находить и ис- 
правлять ошибки (рис. 7.1). 


Файл Правка Вид Стиль Настройки 


Сатьпа 711 Ал 
вые $© | [& 


ж К] Ч «хх АР. 


*у 
/ 


{= Классический пример 


1 
Шрифт Абзац 2 

Е /*= первой программы */ 

Я, , 7 Е] [- 

ИВР: В СЕР ЕЕ ЗЕРЕН. НИЕМ - р на языке Си 7 
5 ЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕ=*, 
Глава первая еле павыы 

7 11 та1т () { 
8 рг1пЕР ("Не110, мог19!\п"); 
9 гефигп 8; 

Алисе надоело сидеть на 5 } > 


пригорке рядом с сестрой и 
ничего не делать. Раз или два 
она заглянула украдкой в 
книгу, которую читала её 
сестра, но там не было ни 
разговоров, ни картинок. 


= 
= 


Рис. 7.1 
Оформление текста в текстовом процессоре (слева) и текстовом редакторе 
с подсветкой синтаксиса (справа) 

Языки разметки позволяют совместить преимущества текстовых процес- 
соров и простых текстовых редакторов, чтобы получить для произвольного тек- 
ста эффект, подобный тому, который делают для исходных текстов программ 
текстовые редакторы с подсветкой синтаксиса. С помощью языков разметки 
можно, используя только набираемые с клавиатуры символы, отметить смысло- 
вые блоки текста: заголовки, абзацы, перечисления, списки. Тогда любые про- 
граммы, знакомые с языком разметки, смогут распознать структуру текста и по- 
разному оформить его структурные элементы. 

Для внесения в произвольный текст информации о его смысловых блоках 
1\7(Ф 9 5 (9) изобрести разные способы. Можно, например, заключать участки текста 
в своего рода скобки, как это делается с комментариями в языке Си: /* Это ком- 
ментарий */. Можно использовать различную величину отступов от левого края. 
Важно ЛИШЬ, чтобы принятое соглашение не входило в противоречие с осталь- 
ным текстом, и желательно, чтобы оно было удобным для использования, пото- 
му что в отличие от текстовых процессоров, где оформление накладывается на 
текст инструментальным способом, писать на языке разметки зачастую прихо- 
дится непосредственно человеку. 

Рассмотрим языки разметки, которые предлагается использовать Для 
оформления страниц документации в Е0$$1. 
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7.3. Язык разметки ММК! 


Когда встречают слово УМ (которое, кстати, имеет корни в гавайском 
языке, где оно означает «быстро»), то обычно представляют Википедию — 
грандиозный информационный ресурс, размещённый в сети Интернет. В систе- 
ме Роз УМК! — это всего лишь набор взаимосвязанных страничек с текстом, 
которые легко создавать через веб-интерфейс этой системы и которые удобно 
там же просматривать. А для того, чтобы документация лучше воспринималась, 
предлагается использовать специальный язык разметки. 

Основным структурным элементом страницы текста является абзац. 
В разметке \/ПА достаточно между абзацами текста вставлять пустые строки, 
чтобы система их правильно интерпретировала и отображала. Если требуется 
увеличить поле слева от абзаца, то составляющие его строки надо предварять 
двумя или более пробелами либо использовать табуляцию. 

Довольно часто в текстах присутствуют перечисления каких-нибудь эле- 
ментов, списки. Они бывают двух типов: нумерованные, в которых важен поря- 
док, и поэтому каждый элемент снабжается своим номером, и ненумерованные, 
в которых порядок не важен. Чтобы оформить список без нумерации, надо каж- 
дый его элемент начинать с новой строки вида: 


х очередной элемент 


Важно, чтобы вокруг звёздочки находилось не менее двух пробелов с 
каждой стороны — тогда система отображения распознает в строке элемент 
ненумерованного списка и отобразит его со смещением от левого края, заменив 
звёздочку на закрашенный кружок. С учётом изложенных требований список 
можно оформить так: 
картина; 
корзина; 


картонка; 
собачонка. 


ххх 


Элементы нумерованного списка оформляются таким же образом, ТОЛЬКО 
вместо звёздочки ставится символ «решётка». Например, перечень этапов раз- 
работки проекта может быть записан в таком виде: 

# Проектирование. 

Реализация. 


# 
# Внедрение. 
# Эксплуатация. 


Система отображения, встретив правильно оформленный блок элементов 
нумерованного списка, сама заменит решётки на последовательные числа 
(рис. 7.2). 

Одно из наиболее значимых преимуществ электронной документации по 
сравнению с бумажным аналогом — возможность установления множествен- 
ных связей между отдельными страницами. Не удивительно, что \1-разметка 
предоставляет удобное средство для создания гиперссылок. Чтобы сослаться из 
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какого-то места документа на другой документ, надо адрес ссылки заключить в 
квадратные скобки, например: 


[ВЕ6р://Ео$$11-зсм.ога] 


Дама сдавала в багаж 


» картину; 
» корзину; 
» картонку; 
» собачонку. 


Этапы жизненного цикла компьютерной программы 


1. Проектирование 
2. Реализация. 

3. Внедрение 

4. Эксплуатация 


Рис. 7.2 
Отображение ненумерованного и нумерованного списков 

Такая запись приведёт к тому, что в документе появится надпись 
«БИр://Ро$$1-5ст1.оге», которая одновременно является активной гиперссылкой 
на официальный веб-сайт проекта Ео$$1, т.е. при щелчке мышью по этой 
надписи в веб-браузере откроется сайт, соответствующий ссылке. 

Если адрес веб-сайта длинный и его размещение в тексте нежелательно, 
то можно его замаскировать каким-нибудь текстом. В приведенном примере ги- 
перссылку можно записать в таком виде: 

[РЕБр://Ео$$11-зсм.ога | официальный веб-сайт] 


Теперь вместо адреса веб-сайта в документе будет присутствовать 
надпись «официальный веб-сайт», являющаяся гиперссылкой с указанным ад- 
ресом. 

Но наиболее значимое преимущество интегрированной в систему Е0о$$1 си- 
стемы документирования заключается в том, что в качестве адреса для гиперссыл- 
ки можно использовать идентификатор сущности системы контроля версий. Каж- 
дый объект, попавший в Еоз31, получает свой уникальный номер — идентифика- 
тор, который выглядит, например, так: 0166693512Н60сЬ218аа136610399850ас925 
еб60ес19{3236с213698са7711. Если воспользоваться этим номером в качестве 
адреса гиперссылки (обычно достаточно указать его первые 10 символов), то 
система Ео$51 создаст гиперссылку на идентифицируемый им объект хранения, 
например моментальный снимок рабочего каталога в репозитории. Тогда при 
щелчке по гиперссылке [01666493512] откроется веб-страница с участком шкалы 
времени проекта, содержащая описание указанной точки сохранения. 

Аналогичным образом можно ссылаться из документации на заявки на 
доработку, которые тоже имеют свои уникальные идентификаторы. Такой меха- 
низм позволяет быстро увязать все сведения, относящиеся к рассматриваемому 
на создаваемой страничке вопросу. 
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Если перечисленных средств форматирования недостаточно, то можно 
воспользоваться большинством тегов, составляющих язык гипертекстовой раз- 
метки НТМЕ и позволяющих выделять в тексте отдельные элементы. Тег — это 
последовательность из одной или нескольких букв английского алфавита и 
цифр, размещённая между угловыми скобками < и >. Например, <Нг> — тег, обо- 
значающий горизонтальную разделительную линию в тексте. 

Для обозначения участка текста обычно требуется указать его границы — 
места, где он начинается и заканчивается. Теги выступают в роли своеобразных 
многосимвольных скобок — открывающей, которая обозначает начало выделя- 
емого участка текста, и закрывающей, которая обозначает его конец. Закрыва- 
ющий тег отличается от открывающего тем, что в нём перед словом ставится 
символ /. Например, абзац обозначается так: 


<Р>здесь находится текст абзаца</Р>. 


Наиболее полезными для разметки текста элементами являются заголовки 
и таблицы. Заголовки текста оформляются с помощью тегов <Н1>, <Н2> ... <Н7> 
(от англ. Веадег — заголовок, цифра указывает на уровень заголовка — от круп- 
ного к более мелким). Например, начало сказки Льюиса Кэррола «Алиса в 
Стране чудес» может быть оформлено следующим образом: 
<Н1>Глава первая</Н1> 
<Н2>В кроличьей норе</Н2> 


<Р>Алисе надоело сидеть на пригорке рядом с сестрой и ничего не 
делать.</Р> 


Таблицы оформляются с помощью тегов <ТАВЕЕ>, <ТВ>, <ТН> и <ТО> 
следующим образом: 
<ТАВЬЕ> 
<ТВ><ТН>М п/п</ТН><ТН>Название предмета</ТН><ТН>Учебных<ВВ>часов</ТН></ТВ> 
<ТВ><ТО>1</ТО><ТО>Математический анализ</ТО><Тр>86</ТЬ></ТвВ> 
<ТВ><ТО>2</ТО><ТР>Аналитическая геометрия</ТрО><Тр>72</Тр></ТВ> 
<ТВ><ТО>3</ТО><Тр>Программирование</ТО><Тр>80</Тр></Тв> 
</ТАВЬЕ> 

Тегом <ТАВЕЕ> обозначаются начало и конец блока, в котором находится 
описание структуры таблицы. Таблица представляется последовательностью 
строк, которые заключены в теги <ТВ> (от англ. ‘ае го\ — строка таблицы). 
Каждая строка состоит из ячеек, для обозначения которых служат теги <ТО> (от 
англ. {ае даа — данные таблицы). В первой строке вместо тегов <ТО> исполь- 
зованы теги <ТН>, которые специально предназначены для выделения заголов- 
ков колонок таблицы (от англ. 1аШе Беадег — заголовок таблицы). Одиночный 
тег <ВА> заменяется на перевод строки и в приведенном примере способствует 
уменьшению ширины третьей колонки таблицы. 

Некоторые теги допускают использование атрибутов, которые записыва- 
ются после названия тега через пробел перед закрывающей угловой скобкой. 
Например, чтобы текст в ячейке таблицы был отцентрирован по горизонтали, 
можно использовать атрибут АНСМ со значением СЕМТЕВ следующим образом: 


<ТР АГТСМ="СЕМТЕВ"> содержимое ячейки </ТЬ> 
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Основные варианты стилевого оформления участков текста — выделение 
жирным шрифтом, курсивом и подчёркиванием — можно выполнить с помо- 
щью тегов <В> (от англ. Бо]4 — жирный), <|> (от англ. ИаНс — курсивный) и <> 
(от англ. ипде те — подчёркивание) следующим образом: 


<Р>В этом абзаце демонстрируется оформление <В>жирным шрифтом</В>, 
<Т>курсивом</Т> и <ПО>подчёркиванием</0> участков текста.</Р> 


Отформатированный описанными способами текст на странице докумен- 
тации будет выглядеть, как показано на рисунке 7.3. 
Глава первая 
В кроличьей норе 


Алисе надоело сидеть на пригорке рядом с сестрой и ничего не 


делать 
М№п/п Название предмета Учебных 
часов 
1 Математический анализ 86 
2 Аналитическая геометрия 72 
3 Программирование 80 


В этом абзаце демонстрируется оформление жирным шрифтом, 
курсивом и подчёркиванием участков текста 


Рис. 7.3 
Отображение отформатированного текста на ИЙ-страничке 
В документации к программному продукту наверняка встретятся участки 
кода, иллюстрирующие текстовое описание. Их надо оформлять с помощью те- 
гов <МОМЛК>, <РВЕ> и <СООЕ> следующим образом: 


<МОМТКТ><РВЕ><СОРЕ> 
Еог 1 11 капае (8): 


Еог ) 1п гапоае (8): 
ТЕ (1+)) $2: 
рг1пЕ (' .', епа = "'') 
е1 зе: 
рг1пЕ (' +', епа = "'') 
ретиЕ () 


</СОРЕ></РВЕ></МОИТКТ> 


В приведённом примере тег <МО\МИК> отключает внутри блока трактовку 
специальных комбинаций символов в качестве элементов разметки, в результате 
чего содержащийся в нём текст отображается как есть. Тег <РАЕ> сохраняет 
пробельные отступы и переносы строк, что особенно важно для языка про- 
граммирования Ру®оп. А тег <СООЕ> информирует систему отображения, что в 
указанном блоке содержится текст на языке программирования. Обычно это 
приводит к тому, что текст отображается монотипным шрифтом. 

Если в тексте, оформленном в соответствии с разметкой УИ, надо явным 
образом представить знаки «меньше» или «больше», то, чтобы система не пере- 
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путала их с обозначением тега, их надо заменить специальными фразами: &1; 
(от англ. 1е55 ап — меньше чем) и &91; (от англ. этежег фап — больше чем). Та- 
кая замена не требуется внутри блоков <МО\МИКР>. 


7.4. Язык разметки МагКкаомт 


Язык разметки МагК4о\уп был придуман в 2004 г. Джоном Грубером (Лобп 
Отибег) и Аароном Шварцем (Аагоп З\’аг7). Идея заключалась в таком обозна- 
чении структурных элементов текста (заголовков, абзацев, списков), чтобы эта 
разметка естественно выглядела в тексте при просмотре его в обычном тексто- 
вом редакторе, но при необходимости могла быть преобразована в оформление, 
соответствующее правилам НТМГ, или других языков разметки. 

Над синтаксисом языка МагКкдо\уп его авторы работали совместно. В ито- 
ге Джон Грубер написал одноимённую утилиту, которая преобразовывала текст 
с разметкой МаК4о\т в документ НТМГ, а Аарон Шварц — утилиту Ми! ехь 
решающую обратную задачу. 

По мнению авторов Маткао\п, для лучшего его понимания надо сразу 
рассмотреть пример текста, оформленного с его помощью. Последуем этому 
совету и оформим примеры из предыдущего раздела в стиле МагК4доу\т: 


Листинг. Текст с разметкой в стиле Магк4о\т 


Глава первая 


Алисе надоело сидеть на пригорке рядом с сестрой и ничего не делать. 
Раз или два она заглянула украдкой в книгу, которую читала её сестра, 
но там не было ни разговоров, ни картинок. 


+## Дама сдавала в багаж: 


картину; 
корзину; 
картонку; 
собачонку. 


Е: ОСЗ 


+## Этапы жизненного цикла компьютерной программы: 


Проектирование. 
Реализация. 
Внедрение. 
Эксплуатация. 


Ну на на кз 


В этом абзаце демонстрируется оформление **жирным шрифтом** и 
_курсивом_ 
участков текста. 
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М п/п | Название предмета | Учебных часов | 


:1 : Математический анализ |:86 : | 
:2 :|Аналитическая геометрия |: 72 $: | 
:3 : | Программирование |: 80 : | 


Еог 1 1п гапоае (8): 


Рог ) 1п гапае (8): 
ТЕ (1+)) $2: 
рг1пЕ (' .', епа = '') 
е1зе 
рг1пЕ (' +', епа = "'') 
рефпе () 


Как можно видеть, текст, оформленный в стиле Магкдо\т, вполне читаем 
в своём первоначальном виде, и с первого взгляда трудно понять, где здесь во- 
обще элементы разметки. Поэтому рассмотрим этот пример более подробно. 

Начнём с заголовков. Заголовки первого уровня в разметке Макао\т — 
это текст, подчёркнутый с помощью символов «равно», а заголовки второго 
уровня — текст, подчёркнутый с помощью символов «минус». В приведенном 
примере это «Глава первая» и «В кроличьей норе» соответственно. На самом 
деле, достаточно трёх подряд идущих символов подчёркивания, чтобы разметка 
сработала. 

Заголовки следующих уровней обозначаются подряд идущими символами 
«решётка» перед текстом заголовка. Количество символов соответствует уров- 
ню заголовка. В приведенном примере есть два заголовка третьего уровня, это 
«Дама...» и «Этапы...». В принципе, заголовки первого и второго уровней мож- 
но тоже помечать соответственно одним и двумя символами «решётка», однако 
приведённый в примере вариант выглядит в тексте более наглядным и аккурат- 
ным. На веб-странице же оба варианта будут выглядеть одинаково. 

Ненумерованный список, как и в \/И1-разметке, может быть создан путём 
размещения символов «звёздочка» перед его элементами. Допустимо также ис- 
пользовать символы «плюс» и «минус», если это улучшает вид исходного текста 
документа. 

В начале строки любая цифра со следующей за ней точкой означает эле- 
мент нумерованного списка. Следить за нумерацией в исходном тексте нет 
необходимости — при обработке исходного текста будут автоматически про- 
ставлены возрастающие номера. Это продемонстрировано в приведенном при- 
мере, для чего перед каждым элементом нумерованного списка стоит обозначе- 
ние «1.». На практике лучше и в исходном тексте использовать возрастающие 
номера, это сделает его более естественным. В нумерованных списках допуска- 
ется замена точки на закрывающую круглую скобку. 

МагК4о\т позволяет выделить отдельные слова текста жирным шрифтом 
или курсивом. Для этого перед и после слова надо поставить признаки выделе- 
ния: две подряд идущие звёздочки (жирный шрифт) или один символ подчёрки- 
вания (курсив). На рисунке 7.4 показано, как выглядит оформленный в стиле 
МагК4о\т текст на веб-странице после применения стилей. 
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Глава первая 
В кроличьей норе 


Алисе надоело сидеть на пригорке рядом с сестрой и ничего не 
делать. Раз или два она заглянула украдкой в книгу, которую 
читала её сестра, но там не было ни разговоров, ни картинок. 


Дама сдавала в багаж: 


картину; 
корзину; 
картонку; 
собачонку. 


Этапы жизненного цикла компьютерной программы: 


1. Проектирование 
2. Реализация 

3. Внедрение 

4. Эксплуатация. 


В этом абзаце демонстрируется оформление жирным шрифтом и 
курсивом участков текста. 


Рис. 7.4 


Веб-страница, построенная на основе текста с разметкой Макао 


Таблицы тоже размечаются наглядным способом. Колонки разделяются 
символами вертикальной черты, заголовок таблицы отделяется от еб тела гори- 
зонтальной линией из знаков «минус». 

По умолчанию содержимое ячеек заголовка таблицы выравнивается по 
центру, а содержимое ячеек тела таблицы — по левому краю. Это можно изме- 
нить, если поставить двоеточие внутри ячейки рядом с той границей, к которой 
требуется выровнять содержимое. Если двоеточия стоят у обеих границ, то со- 
держимое будет выровнено по центру. 

Вставить листинг программы в текст с помощью Магкдо\т очень просто. 
Достаточно начало и конец листинга обозначить линиями из обратных кавычек. 

Отображение на веб-странице таблицы и листинга программы, размечен- 
ных с помощью МагК4оу\гп, показано на рисунке 7.5. 


Мп/п 
1 


Название предмета 
Математический анализ 


Учебных часов 
86 


2 Аналитическая геометрия 
3 Программирование 


Фог 1 1т гапре (8): 
Рог ] 1т гапее (8): 


72 
80 


#+9+))%2: 


рг1пЕ (’ .'’, епа 


е15е: 


рг1пЕ (’+', епа 


реЗп* () 


Рис. 7.5 


Веб-страница с таблицей и листингом программы, размеченными с помощью Магк4оуи 
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7.5. Доступ к системе документирования 


Работа с документацией в системе Роз5Й осуществляется через веб- 
интерфейс. По умолчанию участники проекта могут только просматривать 
документацию. Чтобы увидеть список имеющихся страниц документации, 
надо воспользоваться пунктом горизонтального меню \/К! | М$, пунктом рас- 
крывающегося меню 15$ оЁ УМК Радез или перейти по гиперссылке 
Бр :/№$$1.зегуег:8081Амсощег{ (рис. 7.6). 


© тре япоае-раде мебзИе: М Хх + я ы * 
< С О Незащищено | Фю$5й.5егуег8 08 1Ам х @ 
= р А 
зитр!е зтае-раде меь$ЁКе / мжнер 
= Ноте Титейпе Е|ез ВгапсВез УМК зегз 
[5 № 
= О х 
© тре эпае-раде \мебзе; М х + 
— С О Не защищено | +05$Й,5егуег8 081 ДмКте!р и © 
эитр!е этае-раде мез$Ке / мкнер 
= Ноте Титейпе [Иез Вгапспе$ Узегз 
» Ноте Раде ® [090щ 
» Ее Вгомзег о Свапае Раз$мога 
о Гтее-ме\м, Тгипк Свеск-п о Етай Аей$ 
о Нармем ® Керозйогу З{аи5 
о Ее адез Тог Тгипк © Сойзоп$ оп Ваз ргейхез 
© Ипуегзюопед Е\ез о |151 оГОРЕ$ изед © ассез$ {115 герозЙогу 
е МЮ о |131 оГАНИас5 
о | [151 о МК! Радез о 1151 о7"Титемагр" Спеск-п$ 
о КесегИ асйуйу » Нер 
© Запабох о Ик Роппайтд Вищез 
о [151 ог АНасптепи!$ о Магкаомт Еогта#пд В \ез 
» Пске о |151 оГА! Соттапд$ апа \Меб Радез 
о Кесег( асёмйу о А! "Пар" 4ех{ оп а зпае раде 
о [151 ог АНасптеги5 о РЕИепате зи х {о ММЕ {уре тар 


Рис. 7.6 
Просмотр страниц документации 

Чтобы создавать новые страницы документации и изменять содержимое 
существующих страниц, пользователь должен обладать необходимыми для это- 
го полномочиями. Их может предоставить администратор системы путём от- 
метки соответствующих пунктов на карточке учётной записи пользователя. 
К системе документирования относятся пять разрешений (рис. 7.7): 

® Неаа \\МК! — чтение документации; 

® Мем МКГ — создание новой страницы документации; 
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® Аррепа ММК! — дополнение существующей страницы документации; 
® \\/Ше ММК! — написание документации; 
® Модегае М/К! — модерирование документации. 


© 5треЕ эпа-раде меБзйе: Ей Хх + 


= С ОФ Не защищено | +0551,5егуег:8081/зеир_иеди?4=6 & у 


этр/е этае-раде мере 


= Ноте Ттенпе ЕИез Вгапсвез Изегз 


Сапсе! 


ег 0: 6 
Тодт тпрозег1 


Сотасе п: |{тр1@Ро$511.зегуег 


Сара Иез: Адтт НурейпК$ [д] 

® Веадег 

“ Оеуеюрег Сопе[м 
Беер] Реад МИКИм 
Мем-РИ р] Я Мем мик 
Раззмога [в] Аррепа \\ИКИ д} 
Српеск-шп 8). \\Мгие МАК в] 
Спеск-ОШ (нц Модегайе ММК 


Заес!ед Сар: 23Ы му (кеу) 
Разз\м/ога: |********** 


_Арру Спапоев | | деке Цвег || Сапсе! 


Рис. 7.7 
Права доступа к документации. Чтобы разработчики проекта могли создавать 
новые страницы документации и прикреплять к ним файлы, им надо предоставить 
разрешения Ме’ ИПМ и АНасйтепв5 

Разрешение на чтение документации (Кеа4 \/Па, код ]) имеется у группы 
[М]ободу, к которой относятся все посетители веб-интерфейса Ео$$1, поэтому 
отдельно его предоставлять необходимости нет. 

Пользователи, входящие в группу [®]еадег, автоматически приобретают 
право на редактирование существующих страниц документации (Утие УЛ, 
код К). 

Анонимные пользователи, входящие в группу [Апопутои$, к которым 
относятся любые пользователи, авторизовавшиеся в системе, тоже имеют воз- 
можность оставить свой след в документировании проекта. У них есть разре- 
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шение на дополнение существующей страницы документации (Аррепа УП, 
код т), позволяющее им дописывать свой текст внизу страницы. 

Создать новую страницу документации рядовой участник проекта, кото- 
рому обычно назначаются группы разрешений [еа4ег и []еуеюрег, не смо- 
жет, если ему не будет явно предоставлено разрешение Ме\у \У Па (код В. А что- 
бы иметь возможность дополнять страницы документации файлами, например с 
двоичными данными или иллюстрациями, потребуется ещё разрешение 
А{Цасбтеп( (код Ъ). 

Если в параметры системы документирования Ео5$ специально не вно- 
сились изменения, то в полномочии на модерирование страниц документации 
(Модегае УК) нет необходимости. Новые страницы и внесённые в них изме- 
нения становятся общедоступными автоматически, без предварительной про- 
верки авторизованным пользователем. 


7.6. Создание и редактирование статей 


Сначала список страниц документации пуст. Чтобы создать новую статью, 
надо воспользоваться пунктом дополнительного горизонтального меню Мем 
(Новая) на странице веб-интерфейса УМК! либо перейти по гиперссылке СтеаЕ а 
пеми мК! раде (Создать новую страницу документации) там же (рис. 7.8). 


С (О Не защищено | 10$$Й.5егуег:8081 Лилк д) @ 


© 
— 
зипр!е зтае-раде меб$Ке 
= Ноте тете ЕИез Вгапсвез Ук 


Ш М ему 


% 


МАК! ЫтК$ 

Весеп{ спапдез {0 УМК! радез 
Ропта#тоа гуез ог Го$$1 \\/К! апд фог Магкдомл МЛЮ. 
зе пе ЗапаБох {0 ехрептеги{ 


есп-пое 
к Радез ауайаЫе оп {115 зегуег 


Рис. 7.8 
Переход к созданию новой страницы документации 


После этого будет предложено заполнить простую форму из двух полей со 
сведениями о создаваемой веб-странице (рис. 7.9). В первом поле надо ввести 
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название страницы, которое в дальнейшем будет отображаться в списке страниц 
документации. На название накладываются следующие ограничения: 

® название должно содержать как минимум один, но не более ста симво- 
лов; 

® оно не может начинаться или заканчиваться пробелами; 

® название не должно содержать управляющие символы (табуляцию, пе- 
ревод строки и др.); 

® между словами в названии не должно быть более чем одного пробела. 

Если будет введён текст, в точности повторяющий название уже суще- 
ствующей страницы, то новая страница создана не будет, а будет предложена к 
редактированию одноимённая существующая страница. 

Во втором поле предлагается выбрать из списка язык разметки, который 
будет использоваться для оформления создаваемой страницы. Для выбора до- 
ступны следующие варианты: 

® НоззИ УМЕ 

® Магкао\п; 

® Раш Тех. 

Первые два языка разметки были подробно рассмотрены выше, а третий 
означает обычный текст без форматирования, т. е. к набранному тексту не будет 
применяться никакое стилевое оформление. 

Для перехода к набору содержимого страницы документации надо нажать 
кнопку Сгеае, находящуюся внизу формы. 


= О х 
© тре этае-раде мебзие: Сге- Х + 


< - С О не защищено | 05$1.5егуег:8081 Лмктеми х о 


тре зтае-раде меб$Ке / 
Сгеа!е А Меми \МК! Раде 


=  Ноте ТЛтеште 


Нар [и 


Куез Гог МК! раде патез; 


® Миз{ по! Бедт огепа мВ а зрасе 

®_ Миз{ по{ сощат апу сопго! спагацегз, пси4!пд {аб ог пемМте 
® Миз{ по{ Пауе \мо ог тоге зрасез т а гом/ ицегтайу 

® МизБе Бемееп 1 апд 100 спагацег$ т |епо® 


Мате оЁ пе\ми мК! раде: Оформление веб-страницы 
Магкир зе: Ро$$й ММК! Ы 
Стезме 


Рис. 7.9 
Заполнение сведений о странице документации 
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Открывшаяся форма (рис. 7.10) позволяет изменить язык разметки, ис- 
пользуемый для оформления страницы документации, путём выбора нового 
значения из списка в поле Маир зу (Стиль разметки). 

Содержимое страницы документации набирается в большом текстовом 
поле с использованием выбранного языка разметки. В приведённом примере 
текст оформлен с помощью Магао\т. Когда текст будет набран, надо нажать 
кнопку Ргемем Уоиг Спапдез (Предпросмотр ваших изменений), находящуюся 
внизу формы. Над формой отобразится текст с применением форматирования, 
заданного языком разметки, — таким же его будут в дальнейшем видеть поль- 
зователи. А рядом с нажатой кнопкой появится другая — Арру ТНезе Спапдез 
(Применить эти изменения). Если внешний вид документа устраивает, её можно 
нажать для выхода в режим просмотра страницы из режима её правки с сохра- 
нением выполненных изменений. Кнопка Сапсе! позволяет выйти из режима 
правки без сохранения изменений. 


— О х 
е тре эта!е-раде меб зе; Ед" Ж - 


= С О Не защищено | 551.5егуег8081 Дмюеай ж © 


тре зтае-раде ме $Ке / ез. 


Оформление веб-страницы 
Ноте Ттепе [Иез Вгапсвез 
АНасв 


Ргемем 


Оформление веб-страницы 


Стили оформления веб-странички находятся в файле таех.сз$. 
Чтобы веб-странички одинаково отображались в различных веб- 
браузерах, первоначально производится обнуление значений 
полей и отступов для всех элементов: 


* {шага1п: 0; рааа1та: 0} 


Магкир э\уе: |Мадомп _* 
Оформление веб-страницы 


Стили оформления веб-странички находятся в файле _тдех.с$$_. 


Чтобы веб-странички одинаково отображались в различных веб-браузерах, 
первоначально производится обнуление значений полей и отступов для 
всех элементов: 


`* {птага: 0; рад до: 0}` 
д“ Уосиг Свапдез || Арру ТВезе СНапдез | Сапсе! 


Рис. 7.10 
Заполнение содержимого страницы документации 
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Чтобы исправить имеющуюся страницу документации, надо открыть её 
для просмотра, перейдя по гиперссылке с её названием в списке страниц 
(рис. 7.11). После этого в дополнительном горизонтальном меню, находящемся 
над содержимым страницы, надо выбрать пункт ЕОй. 


© этлоЕ эпае-раде мебзйе: Аз Хх + 


< С О Не защищено | ю$$1.5егуег 8081 Лисотеги х @ 


тре зэтае-раде меьзКе / 


АуайаЫе ММК! Радез 


=  Ноте Ттешпе 


АЙ Нар Ме\и 


© тре зпче-раде мебзйе: Оф Х + 


Мате | 


Адаптивность веб-страницы = С О Незащищено | ю$$й.5егмиег 8081 


Макет для разработки 
тре этае-раде 


Оформление веб-страницы 
Оформление веб-страницы 


Разметка веб-страницы 


=  Ноте Ттеше 


ед Ногу 


Оформление веб-страницы 


Стили оформления веб-странички находятся в фа 


Рис. 7.11 
Исправление страницы документации 


Интерфейс и процедура редактирования страницы документации полно- 
стью аналогичны таковым при недавно описанном создании новой страницы. 


7.7. Добавление файлов и изображений 


Если у пользователя имеется разрешение на прикрепление файлов 
(Айасотеп), то над формой в дополнительном горизонтальном меню будет 
присутствовать пункт АНасН. С его помощью можно, например, прикрепить 
файл с иллюстрацией (рис. 7.12). 
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-: | х 
© тре этае-раде меБзИе: Ед" Хх + 
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© тре зтае-раде меб зе: Ад Х + 


— Ноте Тг 
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Магкир зе: | Макдомт у 
Оформление веб-страницы 


< С АД Не защищено | 105$1.зегуег:8081/аИаспада? р: 5% [о 


зипр!е зтае-раде мезКе / 


= Ноте Титенпе [Иез Вгапспез 


АЗа АНасИтеп! То УЛК! Раде Оформление веб-страницы 


РИе \о АНасп: | Выберите файл | сеп{ег-дего.дИ 
Безсирноп: : 
Иллюстрация центрирования блока по горизонтали. 


АЗд АНасптег! | Сапсе! 


Рис. 7.12 
Прикрепление файла к странице документации 

Для этого на открывшейся форме надо нажать кнопку Выберите файл и 
указать на добавляемый файл в стандартном окне диалога выбора файла. До- 
бавляемый файл можно снабдить описанием, заполнив текстовое поле 
Оезсирноп. После этого для прикрепления выбранного файла надо нажать кноп- 
ку Ада Анасптеп" (Добавить вложение). Отказаться от выполнения операции 
можно с помощью кнопки Сапсе! (Отменить). 

Добавленные файлы попадают в блок АНасптеп, находящийся в нижней 
части страницы документации. По гиперссылке деай$ открывается страничка с 
описанием вложения. 

Добавленное изображение можно использовать на странице документа- 
ции. Для этого в языке разметки Ео$$ УК надо воспользоваться тегом <!М@ 
5ВС="Адрес изображения" АЁТ="Описание изображения">, а в МагК4до\уи имеется 
такая конструкция: 


! [Описание изображения] (Адрес изображения) 


После восклицательного знака в квадратных скобках указывается тексто- 
вое описание вставляемого изображения, а следом за ним в круглых скобках — 
его адрес. 

Если изображение находится на внешнем сервере в Интернете, в качестве 
адреса надо указать его ОВГ. А для ссылки на файл, хранящийся в системе 
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ЕРоз$|, достаточно указать его идентификатор. Узнать идентификатор прикреп- 
лённого изображения можно на посвящённой ему страничке. Чтобы на неё по- 
пасть, надо в режиме просмотра страницы документации перейти по гипер- 
ссылке, представленной именем прикреплённого файла, как показано на рисун- 
ке 7.13. 


=. О х 
© тре зтае-раде мебзйе: Оф Хх + 


< - С Фнезащищено | 1ю551.5егмег8081/мКпате... о 


эитре зтае-раде мебзКе / 


Оформление веб-страницы 


= Ноте  ТПтеше 
© тре эпаде-раде мебзйе: А х + 


Ес Нер Ногу 
| ы < С О не защищено | ю055й.5егуег.8081/ 


Оформление веб-страницы тре зэпае-раде 


Стили оформления веб-странички нахо, 


а 
[2] 


= Ноте ТПтейле | 
АЧасИтеп{$: 


ный Бу 1трозег1 


Оомипюад Нех |паде 1 Цпе Митбегз 


Аг Мас 8 4с81530сЬе58729408613719453 


АКасптеп! "семег-дето_д!" {0 мк! раде||Оформг 
15 12:22:04. Або аКасбтеги "семег-дето.д!” {0 м 
Рис. 7.13 


Для получения дополнительной информации о прикреплённом файле надо 
на странице документации перейти по гиперссылке, представленной его именем. 
Скопировать идентификатор файла можно с помощью пиктограммы Копировать 

В верхней части открывшейся страницы, посвящённой прикреплённому 
файлу, имеется дополнительное горизонтальное меню, содержащее пункты: 

® Оомпоад — скачать файл на локальный компьютер; 

® Нех — просмотреть содержимое файла в шестнадцатеричном виде; 

® |таде — просмотреть файл как изображение; 

® Ппе Митрбег$ — если файл текстовый, то включить для него отображе- 
ние номеров строк. 

Под этим меню размещена строка с полным идентификатором файла в си- 
стеме Еоз$1. Чтобы скопировать в буфер обмена первые символы идентифика- 
тора, достаточные для его указания в ссылке на файл, можно воспользоваться 
пиктограммой Копировать. Для быстрого возврата отсюда на страницу докумен- 
тации служит гиперссылка с её названием (в приведенном примере — Оформ- 
ление веб-страницы). 
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Ссылка на прикреплённый файл должна быть записана в виде: 
/там/идентификатор. Для приведенного примера конструкция вставки иллю- 
страции в документ примет вид: 


! [Иллюстрация центрирования блока по горизонтали] (/хам/4с81530съе58729а) 
Результат такого оформления показан на рисунке 7.14. 


Ргемему: 


Оформление веб-страницы 


Стили оформления веб-странички находятся в файле таех.с$$ 


Магкир У: | МаЖдомт у 


Оформление веб-страницы 


Стили оформления веб-странички находятся в файле _1тдех.с$55_. 


[Иллюстрация центрирования блока по горизонтали] (/гам//4с81530с5е587294) 


Ргеме\м Уоиг Спапдез | Арру ТНезе Спапдез | Сапсе! 


Рис. 7.14 
Страница документации с иллюстрацией 


Ошибочно прикреплённый файл можно удалить. Для этого надо перейти 
по гиперссылке деайз (подробности), имеющейся на странице документации 
под её основным содержимым в информационном блоке со списком прикреп- 
лённых файлов. Открывшаяся страница, помимо детальной информации о фай- 
ле, содержит горизонтальное меню, в котором есть пункт Веве (Удалить). При 
выборе этого пункта будет выведен запрос подтверждения Сопйгт уоц май ю 
деве Ше аНасптепЕ зНомил Беом/ (Подтвердите ваше желание удалить вложение, 
показанное ниже), на который можно утвердительно ответить нажатием имею- 
щейся рядом с ним кнопки Сопйит (Подтвердить). После этого файл будет уда- 
лён. 


7.8. Технические заметки 


Рассмотренные выше страницы документации позволяют создать подбор- 
ку статей, посвящённых различным аспектам реализуемого проекта. Они соби- 
раются в каталог, доступный через пункт меню \\/К! | 1$, в котором представле- 
ны их названия. Такая организация сведений удобна для хранения информации 
в разрезе тем и напоминает алфавитный блокнот. 
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Однако в некоторых случаях информацию удобнее хранить в хронологи- 
ческом порядке. На этом принципе построены блокноты другого типа — еже- 
дневники. Технологичным аналогом ежедневников являются «живые журна- 
лы» — блоги. 

Для ведения дневника проекта в системе Е0$$Й предлагается использовать 
специальный тип страниц документации — технические заметки (‘есбса| 
10$). Эти страницы идентифицируются не своими заголовками, как рассмот- 
ренные ранее, а отметками времени, как точки сохранения файлов проекта. По- 
этому логично, что для их просмотра надо перейти на шкалу времени проекта 
(с помощью пункта Титете основного горизонтального меню) и выбрать кате- 
горию Тесн Моез (по умолчанию на шкале времени отображаются только точки 
сохранения — СКескК-15), как показано на рисунке 7.15. 


© 5тре зпае-раде меБзИе: Ти х + = в > 
< -> С О незащищено | 10551.5егмег8081/тейпе?идс=18155=т&п=508у=е&адут=0 ж о 
= Ноте Титейпе Нез Вгапспез 
Адуапсе |Модет Мем _у | Мах150 [Тесв Ммез *, 


12 4есптса! по{ез 


2020-03-18 


13:00 : в РА 
* Завершён оснобной этап разработки веб-сайта  чесппо!е: [1554494295] изег: \трозег1 {ад: версии, выпуски 


12:30 


2020-03-17 
12:30 


2020-03-15 
12:30 


2020-03-12 
12:30 


2020-03-10 
18:00 


я а С 
› Звершён началфный этап разработки веб-сайта ‘есппо!: [2684344256] изег. ипрозег1 {адз: версии, выпуски 


18:00 


15:00 


12:30 


2020-03-07 
12:30 


Рис. 7.15 
Просмотр технических заметок на шкале времени 


Для таких заметок сразу можно предложить несколько полезных приме- 
нений: 
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® перечисление задач, которые требуется решить по плану реализации 
проекта (при создании заметки можно указывать любую дату, в том числе бу- 
дущую); 

® отмечание этапов реализации проекта, истории смены версий реализу- 
емого продукта; 

® фиксирование моментов смены инструментария, используемого в ходе 
разработки (версии компилятора, системы сборки, программных библиотек); 

® размещение новостных сообщений, консолидирующих информацию о 
текущем состоянии проекта. 

Поскольку технические заметки в Ео$$Й — это просто иначе организован- 
ная категория страниц документации, для работы с ними (просмотра, создания 
и редактирования) пользователям системы необходимы те же полномочия, что 
уже были рассмотрены выше. А для оформления технических заметок исполь- 
зуются рассмотренные ранее языки разметки Ео$5Й \ИК1 и Майкао\п. 

Для создания новой заметки надо воспользоваться пунктом главного ме- 
ню У, после чего перейти по гиперссылке Сгеае а пем 1есп-по!е., или сразу 
перейти по адресу ПНр:/Моз$Й.зегуег:8081Аесппоеесй (рис. 7.16). 


@® тре зпае-раде меб зе: М + 


< С О нНезащищено | Фю5$Й.5егуес8 081 ж о 


тре зэтае-раде мер$Ке / 


= Ноте Титете Е1е$ Вгапспез мик 


МКГ ИтпкК$ 


Весегп{ спапде$ 40 мк! радез 

Рогта па гиез ог Гоз$И УК апа Гог Магкдо\уп Ук 
Узе {пе Запабох {10 ехрептеге 

Сгеае а пе\м/ \/К! раде 
Сгезе а|пе\м {есп-поте: 
[151 оГАН УМК! Радез ауайаЫе оп {1$ зегуег 


Рис. 7.16 
Переход к созданию технической заметки 
Откроется форма для создания заметки, на которой предлагается запол- 
нить следующие поля (рис. 7.17): 
® Птезатр (УТС) — отметка времени заметки, в соответствии с которой 
она будет размещена на шкале времени проекта; 
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® Птеше Соттепт — описание заметки, аналог заголовка страницы до- 
кументации; 

® Ттеше ВасКодгоипа Соог — при установленном флажке Цзе сизют со!ог 
описание заметки будет отображаться на шкале времени с указанным фоновым 
цветом, который можно выбрать из палитры (удобно использовать для визуаль- 
ного разделения заметок по категориям); 

® Тад$ — ярлыки для классификации заметок; 

® Мажир ЭУе — язык разметки, который будет использован для оформ- 
ления содержимого заметки; 

® Раде Сотеп! — текст, составляющий подробное содержимое техниче- 
ской заметки. 


Титез4атр (0ТС): [2020-03-18 12:30:00 


тейпе Соттеп{: Версия 0.90 (предварительная) 


Птенпе Васкогоип4 СоГ: | )е сизют союг: 


Таз: версии 
Магкир ${у!е: | МагКдомт у 


Раде Сомеп!: Подготовлен _предварительный вариант _ 
разрабатываемого веб-сайта. 


- завершена разметка заголовка и содержимого; 
- внедрены графические элементы; 


з - структурирована организация файлов. 
Сапсе! || Ргемем || Зибтй 


Рис. 7.17 
Создание технической заметки 

После заполнения представленных на форме полей надо нажать кнопку 
Ргемем (Предпросмотр), находящуюся внизу формы. Это приведёт к отображе- 
нию над формой описания и содержимого создаваемой технической заметки 
для предварительного просмотра (рис. 7.18). А рядом с кнопкой Ргемем появит- 
ся кнопка Зибтй (Подтвердить), которую надо нажать для завершения процеду- 
ры создания заметки, если просмотренный результат устраивает. 

На странице с текстом содержимого заметки, к которой можно перейти со 
шкалы времени по гиперссылке с её идентификатором, имеется дополнительное 
горизонатльное меню, позволяющее выполнять над ней следующие действия 
(рис. 7.19): 

® АНасН — прикрепить к заметке файл (например, иллюстрацию); 

® СотехЕ — переключиться на шкалу времени к отметке, указанной в за- 
метке; 
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® Оеа! — просмотреть подробные сведения о заметке; 
® Ед — внести изменения в заметку. 


Птейпе соттеп! ргемеми: 


Раде согиеп! ргеме\ми: 
Подготовлен предварительный вариант разрабатываемого веб-сайта: 
® завершена разметка заголовка и содержимого; 


» внедрены графические элементы; 
+ структурирована организация файлов. 


Рис. 7.18 
Предварительный просмотр создаваемой заметки 
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тре зтае-раде мебзКе 


= Ноте Ттеште 


АНасй Сощеж Ое{ай Ед 


Подготовлен предварительный вариант разрабатываемого веб-сайта: 


» завершена разметка заголовка и содержимого; 
» внедрены графические элементы; 
» структурирована организация файлов. 


Рис. 7.19 
Меню технической заметки 
При редактировании заметки надо особое внимание уделять флажку 
Титейпе Васкоагоипа Со!ог, если при создании указывался цвет фона. На форме 
редактирования он всегда снят, и если забыть его установить, то исправленная 
заметка будет отображаться без выделения цветом. 
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7.9. Дополнительные возможности 


Рассмотренная система документирования уже сама по себе является по- 
лезным инструментом. Однако то, что она входит в состав Еоз$1 в качестве од- 
ной из подсистем, открывает дополнительные возможности её применения. 

Если при создании страницы документации указать в качестве её назва- 
ния строку, составленную по шаблону: БгапсН/НазваниеВетвиРепозитория, то со- 
держимое этой страницы будет отображаться в заголовке шкалы времени при 
просмотре ветви с указанным названием. На рисунке 7.20 показано, как эта 
возможность использована для размещения комментария к ветви «заголовок». 


Мате о! пе\ми м/К! раде [Ьгапсь/заголовок 
Макир зу: | Роззй МЛ! у 


| Сгеаве | 


17:52 


2020-03-07 
09:56 


© этлрЕ это-раде мебзйе: Тиу Хх + 
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= Ноте Титешпе Еез Вгапсвез 


Адуапсед 0% ММ |Модет Ме» "| Мах.50 [Снескалв *| 


Ветвь "Заголовок". 


В этой ветви ведётся работа над заголовком веб-страницы 


Ответственный за разработку: верстальщик |трозег2. 


6 спесК-йпз ге|а{ед {о "заголовок" 


2020-03-17 


Рис. 7.20 
Использование страницы документации в качестве комментария к ветви репозитория 


Такие комментарии могут быть особенно полезны для аннотирования 
ветвей репозитория, созданных для проверки тех или иных идей. В них можно 
описать предпосылки для проведения испытания и сообщить полученный в 
итоге результат. Впоследствии эта информация может представлять историче- 
скую ценность для сотрудников, давно работающих над проектом или только 
входящих в курс дела. 
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Подобным образом можно добавить развёрнутое описание к конкретной 
точке сохранения в репозитории проекта. Для этого название страницы докумен- 
тации надо составлять по такому шаблону: спескт/ИдентификаторТочкиСохранения. 
Чтобы магия сработала, идентификатор точки сохранения должен быть указан 
полностью, все 64 шестнадцатеричные цифры. Альтернативный вариант — 
воспользоваться гиперссылкой Ада МИАН! спескт на странице с детальным 
описанием точки сохранения (рис. 7.21). Кстати, рядом с ней имеется гиперс- 
сылка с названием ветви репозитория, позволяющая сразу перейти к созданию 
описания для всей ветви, о чём было сказано выше. 


2020-03-07 
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Рис. 7.21 


Создание развёрнутого комментария к точке сохранения 

Содержимое созданной по таким правилам страницы документации будет 
отображаться в заголовке страницы с детальной информацией о точке сохране- 
ния и является удобным средством для дополнения краткого комментария, ко- 
торым обычно сопровождаются точки сохранения при выполнении операции 
Ю$$Й соттй. 

Несмотря на наличие полезных особенностей у страниц документации, 
созданных по описанным выше правилам, они всё равно остаются обычными 
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\И-страницами, которые отображаются в списке наряду с остальными и точно 
так же могут быть просмотрены, отредактированы и снабжены иллюстрациями. 

Страницами документации можно управлять не только через веб- 
интерфейс, но и посредством командной строки. Если подготовить текст с ис- 
пользованием языка разметки МатКао\уп и сохранить его в каталоге .\\/К в фай- 
ле, например, с именем Уе.та, то создать в репозитории Ео$$1 страницу доку- 
ментации на его основе можно с помощью команды (предполагается, что теку- 
щим является рабочий каталог проекта): 


Еоз$11 м1К1 сгеафе "Стилевое оформление" ..\м1Кк1\з6у1е.ма -М маккаомп 


В этой команде «Стилевое оформление» — это название страницы доку- 
ментации, а с помощью параметра -М указан использованный язык разметки — 
Магкао\т (допустимы ещё варианты Ю$$!— для разметки Е05$П-У/ — 
и рат — для простого неформатированного текста). В случае успешного вы- 
полнения команды на экране появится сообщение: 


Сгтеафеа пем м1К1 раде Стилевое оформление. (Создана новая страница 
документации Стилевое оформление). 


Оно означает, что страница документации создана в локальном репозито- 
рии. В сетевой репозиторий она попадёт в процессе синхронизации, которую 
можно инициировать с помощью команды ю$5$1 ризН или Юз31 зупс. Если стра- 
ницы документации создаются или корректируются через веб-интерфейс непо- 
средственно в сетевом репозитории, то в локальные репозитории они попадут 
тоже после синхронизации, инициированной командой Юз31 ри! или 10$31 зупс. 
Посмотреть перечень страниц документации, имеющихся в локальном репози- 
тории, можно с помощью команды: 


Ео$$11 м1К1 1156 


Возможность управления страницами документации через интерфейс ко- 
мандной строки может пригодиться при автоматизации создания технических 
заметок с помощью сценариев командной оболочки. Для создания технической 
заметки используется команда: 


Ео$$11 м1К1 сгеафе "Версия 1.00 (выпуск 1)" ..\побез\ухегзлоп.м1К1 
—Е 2020-04-21Т12:30:00 -М Ео$$11 

—-сСесрпобе-фачз "версии, выпуски" 

—-Сесрпове-расо1ог суап 


В приведенном примере создаваемая техническая заметка будет датиро- 
вана 21 апреля 2020 г., озаглавлена «Версия 1.00 (выпуск 1)», снабжена тегами 
«версии» и «выпуски» и выделена цветом фона суап на шкале времени. Об 
успешном завершении команды свидетельствует сообщение: 


Сгеабе пем ес пофе 2020-04-21 12:30:00. (Создана новая техниче- 
ская заметка 2020-04-21 12:30:00.) 


Если страница документации или техническая заметка уже существует, то 
внести в неё изменение можно, заменив в приведенных примерах команду 
сгеае на сотти. 
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Создание и изменение страниц документации из командной строки могут 
осуществлять все пользователи Ео5$1|, имеющие право на запись в репозиторий 
сервера (отметка «у» Бемеюрег или «1» Спеск-т на странице настроек пользова- 
теля). Специальных разрешений на работу со страницами документации, как 
для использования веб-интерфейса, здесь не требуется. 

Помимо подсистемы У в Е0$51 реализована возможность ведения до- 
кументации в файлах рабочего каталога проекта. Поскольку эти файлы хранятся 
непосредственно в репозитории вместе с остальными файлами разрабатываемо- 
го проекта, такая документация называется встроенной (БаЙйп). Этот способ 
документирования рассматривается в главе, посвящённой серверу Еоз$1, где с 
его помощью совершенствуется веб-интерфейс. 
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Глава 8 
ФОРУМ 


8.1. Виды и средства коммуникации 


В коллективной работе важную роль играют коммуникации между участ- 
никами проекта. В процессе общения происходят синхронизация осведомлён- 
ности о состоянии проекта, обмен опытом и знаниями, возникает чувство локтя, 
снижается психологическая напряжённость. Коммуникации можно разделить на 
два основных вида: прямые и косвенные. 

Прямая коммуникация — это непосредственное очное общение между 
людьми лицом к лицу. Это наиболее полноценная форма общения, при которой 
между участниками происходит не только обмен сухой информацией в вербаль- 
ной форме, но и передача сигналов с помощью мимики, жестов, интонаций. 
Прямая коммуникация возможна лишь на небольших расстояниях и происходит 
только в настоящем времени. Наряду с положительными сторонами надо отме- 
тить, что оживлённое обсуждение сотрудниками своей проблемы может отвле- 
кать находящихся рядом коллег от работы, мешать сосредоточиться. 

Косвенная коммуникация — это любые формы общения между людьми, 
когда они находятся вне прямой видимости и слышимости. Очевидно, что при 
этом возникает потребность в использовании промежуточных носителей ин- 
формации и вспомогательных средств для её выражения. Раньше наиболее ха- 
рактерной формой косвенной коммуникации были письма (с использованием 
бумаги, пера и чернил), телеграммы и телефонные разговоры (с применением 
электрических сигналов и аппаратов для кодирования сообщений). С появлени- 
ем компьютерных сетей спектр средств косвенной коммуникации значительно 
изменился и расширился. На сегодняшний день важное место в жизни людей 
занимает общение в социальных сетях. Только косвенная коммуникация позво- 
ляет передавать информацию во времени из прошлого в будущее. 

По числу участников средства косвенной коммуникации можно разделить 
на публичные (когда обсуждение доступно для широкого круга участников) и 
частные (когда круг участников намеренно ограничен). По оперативности сред- 
ства коммуникации можно разделить на мгновенные (требующие постоянного 
внимания и незамедлительной реакции участников) и отложенные (когда участ- 
ники обсуждения могут знакомиться с ним и выражать своё мнение в удобное 
для них время). 


8.2. Доступ к обсуждениям 


В системе Ео$$1 в качестве встроенного средства коммуникации между 
участниками проекта предлагается использовать форум — публичное обсужде- 
ние тем, интересных участникам, в удобное для них время. Форум не может за- 
менить другие средства общения, такие как электронная почта или чат, но спо- 
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собен хорошо их дополнить, выступая в качестве канала для неформальных 
служебных записок. 

Участник проекта должен запросить права на доступ к форуму у админи- 
стратора системы. Администратор может установить на карточке пользователя 
следующие отметки (рис. 8.1): 

® Неаа Рогит (код 2) — разрешение, предоставляющее право просмотра 
обсуждений; 

® Ще Рогит (код 3) — разрешение, предоставляющее право создания 
тем и написания ответов; 

® Ме Тизеа Рогит (код 4) — знак особого доверия к пользователю, бла- 
годаря которому его сообщения не требуют проверки и одобрения модератором; 

® Модегае Рогит (код 5) — полномочия модератора, позволяющие про- 
сматривать и принимать решения (одобрить или отклонить) в отношении новых 
сообщений, написанных другими пользователями; 

® Зирег/зе Рогит (код 6) — право назначения участникам форума отмет- 
ки \\Ше Тгизеа Рогит, рассмотренной выше. 
ты О х 


© тре эпав-раде меБзИе: Ед" Хх + 


< (С О Ннезащищено | 10551.5егуег 8081 /ефир_иед и? =8 х @ 


Зиптр/е эзэтае-раде мер$Ке / Ед Чзег Оезюпег Мападег — 1одо! 


= Ноте Тте!пе Ее$ ВгапсВез Озегз 


Сапсе! 


Озег 10: 8 
Год: Оезюпег 


СотщасИп®: |де53пег@Р0$541 .зегуег 


СараБез Ади Нурейикз [д] Веад Пскецк] Оомтюаа 71р [м 


\ Кеадег АНаснтег! Мем/ Тске!5 (д] “ Веад Еогит 

у а С!юпе [м Аррепа То ПскенА] Мне Рогит 
еее Веад \МКин мине Тскес в \У/меТги&еа Рогит 
Мем-РИо] аи НЕ р : Модегаие Рогит 

1 Модегае Тиске{ 
Зирегмзе Еогит 

Раззмога [8] Аррепа МАКА] ТсКе! Верой{я] т Дейе 
Се \тие МАКИ Риуае Зепа Аппоипсетег 
Спеск-Ош м Модегае \МИК \Уите Упуегзюпеа ЕпаЫе ОеБид 


заес{е4 Сар: 23и\у (Кеу) 
Разз\м/огО: |=» 
Арр!у Спапдез || Веве Цзег || Сапсе! 


Рис. 8.1 
Разрешения для доступа к форуму 
Администраторы системы Ео$5П получают все перечисленные разреше- 
ния автоматически, поэтому пользователь Мападег сразу имеет возможность 
выступать в роли модератора, что и будет использовано в рассматриваемом 
примере. 
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Чтобы попасть на форум, надо авторизоваться в системе Е0$$1, используя 
свои имя и пароль пользователя, и выбрать пункт главного горизонтального ме- 
ню Рогит (рис. 8.2). 


@ зтре зпое-раде мебсле: Гого х ПВ а 
< С ОФ не защищено | {0$$,5егиег:8081//огит х @® 
Зипр!е зта!е-раде ме зКе / = аня 
= Ноте тете Ре5 Вгапсбез Тадз Рогит Тске!5 Улк Озегз 
М№ ем Тпгеад 
Рис. 8.2 


Переход на веб-страницу форума 
В некоторых случаях веб-интерфейс Еоз$$Й отображает сокращённый 
набор пунктов главного меню, и тогда пункт Рогит среди них отсутствует. Что- 
бы он отобразился, надо попробовать развернуть окно веб-браузера на весь 
экран. Если это не поможет, то перейти на веб-страницу форума можно из рас- 
крывающегося меню, как показано на рисунке 8.3. 


| 


хх @ 


х 
х 


© тре эпае-раде мебзИе: $ + 


—- 


С О не защищено | 40551.5егуег8081/поте 


Зипр/е эзтае-раде меб Це / тре этае-раде мебзйе 


Мападег — 1090 


= Ноте Титетпе ЕИез Вгапспез Узегз 


®» Ноте Раде 
®» Ее Вгомзег 
о Ттее-ме\у, ТгипКк Свеск-т 
о Набме\м 
о Ее адез Фог Тгипк 
© Ипуегзюпеа Ее; 
® РгдесТитейте 
о Асймйу Верой$ 
о Ее пате сВапдез 


о Рож$ о Мажадомт Рогпта#па Киез 

о Риз 10 спеск-п$ о [151 оГА! Соттапа$ апд Ме Радез 
» Вгапспез о А! "пер" 1ех{ оп а зпае раде 

о Тадз о ЕИепате зийх 0 ММЕ 1уре тар 

о [еа{ Спеск-п$ ® Адгиптгавоп Радез 
фа о Репата Модегавоп Ведиез{5 

о КНесег{ асвуцу о Адтт 109 
® Тске5 о Заз оНпе меб-раде саспе 


о Кесеп( асвуйу 
о [151 о АНасптеп{ 


» МЮ о 1151 о Ме гепатез 
о [151 о МЛК Радез о Раде \ю ехрептег! мА {Пе ащотайс 
о Весег{ асвуйу союгз аззюпед {о Бгапсй патез 
© Запабох о Капдот АЗС!И-ай Сарспа итаде 
о [151 оГАЦасптет $ 


® [0900щ 
о Спапде Разз\ога 
® КерозИогу З!а!и$ 
© СоШзюпз$ оп ВазВ ргейхез 
Из оГ РЕ $ изед {0 ассез$ {115 герозЙогу 
1$ оГ АЦНас5 
$ оЕ"Типемагр" Спеск-п$ 


\лк!: Ропта#та Вщез 


. Тез Радез 
о СС Епмгоптепе Тез! 


1/5Нетар 


Рис. 8.3 
Переход на веб-странииу форума через раскрывающееся меню 
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Возможно, кому-то будет проще открыть веб-страницу форума путём 
набора её ЧВГ в адресной строке веб-браузера: НЁр:/Моз$$1.зегуег:8081 Лоюгит. Все 
перечисленные способы одинаково хороши и приводят к одному и тому же ре- 
зультату. 


8.3. Начало обсуждения 


Изначально форум пуст, о чём говорит сообщение на веб-странице: № 
югит роз{ юипа (На форуме отсутствуют сообщения). Поэтому кто-то должен 
выступить инициатором общения, предложив тему для обсуждения с помощью 
кнопки Ме\м ТНгеаа (Новая тема) (рис. 8.4). 


= | х 
@ тре этпае-раде меБзйе: Рог. Х + 


< - С О Незащищено | 055й.5егуег8081/огит ж о 


тре этае-раде меб $Ке / во 


Мападег — Годощ 


=  Ноте Лтештпе Узегз 
М ем Твгеад а 


№ Тогит ро${$ Ггоипа 


Рис. 8.4 
Создание новой темы для обсуждения на форуме 

После этого будет предложено заполнить форму, которая изображена на 
рисунке 8.5. 

В поле Ргот: (От:) указано имя пользователя, который создаёт тему. В по- 
ле ТШе: (Заголовок:) надо ввести заголовок темы, кратко отражающий круг об- 
суждаемых в ней вопросов. 

В поле Магкир зе: (Способ разметки:) предлагается выбрать один из спо- 
собов записи стилевого оформления, который будет использован при написании 
первого сообщения. Возможны следующие варианты: 

® Роз$й МКГ; 

® Магкаомт; 

® Раш Тех. 

Роз$й М/К! — формат, в котором допускается использование многих тегов 
языка разметки НТМГ. Кроме того, абзацы можно обозначать пустыми строка- 
ми, гиперссылки записывать в виде [УЕ Описание]|, а элементы ненумерован- 
ных и нумерованных списков отмечать символами «звёздочка» * и «решётка» # 
соответственно, стоящими в начале строки и ограниченными с каждой стороны 
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двумя пробелами. Если в блоке текста требуется отключить форматирование, то 
его можно заключить в теги <по\м/К!> ... </по\мК>. 


© тлЕ япае-раде \мебзйе: Мех Х + 


= С АД Не защищено | 05$1.5егуег: 8081 Логитипе\, ж | : 


этр/е зтае-раде ме $Ке / ке 
Рогит Тбгеаад 
Мападег — 1одош 


— Ноте Титейпе Е\е$ Вгапсве$ Озегз 


№ м Тпгеаа: 


Егот: Мападег 

Те: Графические элементы 
Макир 5Уе Макаомт у 
Элина Михайловна, как у вас дела с картинками для нашей странички? Скоро они 
понадобятся верстальщикам. 


Ргемем || Зибтй 
(1 Огупт 


Ведиие подегаюг арргоуа! 
рагате{егз 


Рис. 8.5 
Форма создания новой темы 

Магкаомт — формат, в котором стилевое оформление вместо тегов задаёт- 
ся специальными символами. Например, строка заголовка начинается с симво- 
лов Я, а количество этих символов означает уровень заголовка. Гиперссылки за- 
писываются в виде [Описание](УВ'). Для выделения слова курсивом его надо за- 
ключить в символы * или _, а для выделения жирным шрифтом — в символы ** 
или __. 
Р!ап Тех{ — это обычный текстовый формат, в котором никакие символы 
не несут специальных значений, а отображаются непосредственно в том виде, в 

котором они записаны. 
Большое текстовое поле предназначено для написания первого сообщения 
в создаваемой теме. С помощью кнопки Ргемем (Предпросмотр) можно без за- 
писи сообщения в создаваемую тему форума посмотреть, как оно будет выгля- 
деть после отправки. Это особенно полезно при использовании стилей оформ- 
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ления Го$$! МИК или Маждо\мт, где некоторые комбинации символов могут быть 
интерпретированы неожиданным способом. 

Чтобы создать ветку форума с заданной темой и набранным сообщением, 
надо нажать кнопку Зибтй (Представить), которая становится активной только 
после выполнения предварительного просмотра. 

Если новую тему создаёт пользователь с правами администратора Ео$$1, 
то в нижней части формы отображаются три поля флажков. Два из них предна- 
значены для отладки. 

Установка флажка Эпо\ диегу рагатеег$ (Показать параметры запроса) 
приводит к тому, что после нажатия на кнопку Ргеме\м наряду с демонстрацией 
того, как будет показано сообщение после его отправки, выводятся значения па- 
раметров НТТР-запроса к веб-серверу Еоз$1 (рис. 8.6). 


Ргемеми: 


Графические элементы 
Элина Михайловна, как у вас дела с картинками для нашей странички? Скоро они понадобятся верстальщикам 


ОМТЕМТ ТЕМСТН = 720 
ОМТЕМТ_ТУРЕ = аррйсавоп/х-млмм-гюгт-ипепсодед 
АТЕММАУ _|ИМТЕВРАСЕ = СС/1.0 
ПТР_АССЕРТ_ЕМСОРГИМС = д21р, дейае 
ПТР_НОЗ$Т = ®$$й.зегуег:8081 
ПТР_КЕРЕКЕК = А&р:/Моз5й.зегуег:8081Могитпе\м 
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РАТН_1МРО = Иогите1 
ОЧЕВУ_$ТЕМС = 
КЕМОТЕ_АООК = 192.168.56.1 
КЕСОУЕ$Т_МЕТНОЙ = РОЗТ 
КЕСЧЕ$ЗТ_ОН| = Иогите1 
СЕРТ_МАМЕ = 
оп{егп{ = Элина Михайловна, как у вас дела с картинками для нашей странички? Скоро они понадобятся верстальщикам. 
ите!уре = 4ехИх-тагкдо\мп 
ргемеми = Ргемем 
эпо\мар = оп 
Ще = Графические элементы 


Рис. 8.6 
Отображение параметров запроса 
в режиме Эпом/ диегу рагатеег$ 
Флажок Огу гип (Пробный прогон) предотвращает добавление сообщения 
в тему форума по нажатию кнопки Зибтй. Вместо этого выводится описание то- 


го, какие изменения произвело бы добавление сообщения в системе Ео5$П 
(рис. 8.7). 
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Рис. 8.7 


Отображение описания изменений 
в режиме Гу гип 
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Темы, которые создают пользователи с правами модератора форума, сразу 
становятся доступными для просмотра всем остальным участникам форума. 
Если требуется, чтобы даже созданная модератором тема ожидала проверки и 
одобрения публикации, то надо установить флажок Ведиие тодегаюг арргома! 
(Требуется одобрение модератора). 

В результате подтверждения создания темы кнопкой Зибтй отобразится 
веб-страница с первым сообщением темы (рис. 8.8). Все участники форума под 
сообщением смогут увидель кнопку Веру (Ответить), с помощью которой мож- 
но написать ответное сообщение. Автору сообщения будут доступны ещё две 
кнопки: Едй (Редактировать) — для корректировки сообщения — и Веве (Уда- 
лить) — для его удаления. 
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Веру || Едй || ее 


Рис. 8.8 
Первое сообщение в новой теме 


В этот же момент на главной веб-странице форума, которая ещё недавно 
была пустой, появится строка с созданной темой (рис. 8.9). Слева от названия 
темы отображается, сколько времени прошло с момента её создания. В даль- 
нейшем эта отметка времени будет обнуляться при поступлении в тему новых 
сообщений, что позволяет быстро обнаружить в общем списке активно обсуж- 
даемые темы. Фраза по герйез (нет ответов) справа от названия означает, что от- 
веты на опубликованное в теме сообщение ещё не поступали. В дальнейшем на 
её месте будет отображаться статистика поступления ответов. 
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7.3 Поуг$ адо Графические элементы по герйез 


Рис. 8.9 


Для просмотра обсуждений темы форума надо перейти по гиперссылке, 
представленной её названием 


8.4. Участие в обсуждении 


Чтобы просмотреть сообщения, опубликованные в теме, и, возможно, от- 
ветить на них, надо перейти по гиперссылке, которая представлена названием 
темы. После перехода откроется страничка, изображённая на рисунке 8.10. Пока 
что в теме одно сообщение — то, которое было набрано при создании темы. 
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| Ч, 


Рис. 8.10 
Просмотр темы форума 
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Чтобы поддержать общение по теме, надо ответить на сообщение. Для 
этого предназначена кнопка Веру (Ответить). После нажатия на неё открывает- 
ся форма, напоминающая форму создания темы (рис. 8.11). Только поле заго- 
ловка в ней уже заполнено, теперь достаточно набрать ответ в основном поле 
ввода текста. Единственный нюанс — сначала в нижней части формы присут- 
ствуют лишь две кнопки: Ргемем (Предпросмотр) и Сапсе! (Отмена). Кнопка 
для отправки Зибтй (Представить) набранного сообщения появится только по- 
сле того, как оно будет просмотрено с помощью кнопки Ргеме\. 
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Уже почти всё готово. Последние штрихи - и выгружаю картинки в репозиторий. 


д“ Сапсе! || Зибтй = 


Рис. 8.11 
Подготовка ответа на сообщение форума 

Сообщение, подтверждённое кнопкой Зибтй, попадает в ветку форума, 
посвящённую текущей теме (рис. 8.12). Несмотря на то, что автор сообщения 
видит под ним кнопку Веве, удалить сообщение с её помощью он не сможет. 
При нажатии на неб открывается форма ответа на созданное сообщение. Скорее 
всего, это временная проблема, которая будет исправлена в следующих версиях 
Ео5$1. Однако у неё есть корни, о которых стоит упомянуть. 

В связи с тем, что форум в системе Ео5$1 использует те же механизмы, на 
которых работает система контроля версий, процедура удаления сообщений из 
форума не может происходить обычным образом. Дело в том, что репозито- 
рий — это хранилище, в которое могут только добавляться новые объекты и из 
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которого никогда ничего не удаляется. Поэтому удалить сообщение, отправлен- 
ное на форум, нельзя. Можно лишь изменить его на какое-нибудь другое сооб- 
щение, которое перекроет старое (хотя в истории Е0$$Й старое сообщение всё 
равно сохранится). Это цена, которая вполне оправдана компактностью систе- 
мы. Реализация полноценного форумного механизма в рамках Роз не имеет 
смысла — для этого есть специализированные решения. 


52 | х 


© тр 


е зпа!е-раде меб зИе: гоп Ж + 


е защищено | 0551.5егуег:8081/огитроз1/53499#6504 
= @ Фн 0551 081/% Д95Ь х 


эитр!е зтае-раде ме з$Ке / гого сеолег ово 


= Ноте тейпе [ез Вгапсвез$ 


Графические элементы РЁр:/Мо$$й.зегуег:8081/огитро$/8695069876 


(1) Ву Мападег оп 2020-03-15 13:45:20 [пк] 


Эпина Михайловна, как у вас дела с картинками для нашей странички? Скоро они понадобятся 
верстальщикам 


Веру 


(2) Ву Везюпег оп 2020-03-15 14:24:24 п геру © 1 


Уже почти всё готово. Последние штрихи - и выгружаю картинки в репозиторий. 
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Рис. 8.12 
Тема форума после опубликования ответа. Гиперссылка [ТК] позволяет обращаться 
к сообщению из других тем или подсистем Ео55И 

Стоит обратить внимание на гиперссылку [пк], которая находится в заго- 
ловке сообщения. Она представляет собой постоянный адрес этого сообщения на 
форуме. Её можно копировать в буфер обмена с тем, чтобы потом использовать 
для ссылки на сообщение из других информационных ресурсов системы Го$$1, 
например при написании заявки на доработку. Такие, казалось бы, мелочи обо- 
гащают информационное наполнение проекта, упрощают донесение своих мыс- 
лей до других участников и включают всю накопленную информацию в активное 
пользование. При щелчке по этой гиперссылке на форуме соответствующее ей 
сообщение становится активным, т. е. выделяется фоновым цветом. 

Теперь посмотрим, как выглядит обсуждение с точки зрения пока ещё 
стороннего наблюдателя — верстальщика |трозег1. Вот что он увидит, если 
зайдёт прямо сейчас на страницу, посвящённую обсуждаемой теме (рис. 8.13). 


212 


{тре этое-раде \мебзИе: Рог. Х + 


< С ОФ не защищено | 105$й.5егуег8081//огитро 


этр/[е зэтае-раде меб з$Ке / кого тоьзьн пои 


= Ноте Птеште Ее5 Вгап 


Вгопо!одса! 


Графические элементы 
(1) Ву Мападег оп 2020-03-15 13:45:20 


Элина Михайловна, как у вас дела с картинками для нашей странички? Скоро они понадобятся 
верстальщикам. 


Веру 


(2) Ву Везюпег оп 2020-03-15 14:24:24 [йпК] гп геру 10 1 


Аигайта Модегаюг Арргоуа! 


Рис. 8.13 
Сообщения на форуме в ожидании модерирования 

Ответ, который был написан дизайнером, обозначен на форуме блоком, 
состоящим из заголовка (в котором указано имя автора и время создания сооб- 
щения) и фразы Амайта Модегаюг Арргоуа! (Ожидает одобрения модератором), 
которая заменяет оригинальный текст сообщения. Так работает механизм защи- 
ты форума от спама: сообщения от рядовых пользователей, не являющихся мо- 
дераторами, не отображаются до тех пор, пока не будут проверены и одобрены 
одним из модераторов. 


8.5. Действия модератора 


Единственный пользователь, который имеет права модератора в рассмат- 
риваемом примере, — это администратор системы, менеджер (Мапазег). Вот 
как для него выглядит то же самое обсуждение (рис. 8.14). 

Во-первых, модератор видит всё сообщение целиком, вместе с его ориги- 
нальным текстом. Во-вторых, после ознакомления с текстом сообщения модера- 
тор может опубликовать его так, чтобы оно стало видно всем посетителям фо- 
рума. Это выполняется с помощью кнопки Арргоуе (Одобрить). Если же текст 
сообщения не удовлетворяет пользовательским соглашениям, то с помощью 
кнопки Веес! (Отклонить) модератор может отказать в его публикации. В по- 
следнем случае сообщение скрывается от всех пользователей. 
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Рис. 8.14 
Вид сообщений с точки зрения модератора 

Если пользователь, опубликовавигий сообщение, заслуживает доверия, то 
модератор может перед одобрением установить флажок Тгиз{ изег ... зо {Па! ИЩиге 
роз{$ Чо по! гедийе тодегаНоп. Тогда в дальнейшем сообщения, отправляемые 
этим пользователем, будут сразу опубликовываться для всех участников фору- 
ма, не требуя одобрения модератора. 

Как и любой другой пользователь форума, модератор может принять уча- 
стие в обсуждении. Такую возможность ему предоставляет кнопка Веру для от- 
вета на сообщение. Процедура написания ответа уже была рассмотрена выше. 
В отличие от рядовых пользователей, модератор может осуществлять над опуб- 
ликованными сообщениями дополнительные действия. 

Во-первых, с помощью кнопки Ед он может внести изменение в сообще- 
ние любого пользователя. Процедура редактирования работает точно так же, 
как и ввод нового сообщения или ответ на существующее, за тем лишь исклю- 
чением, что поле для ввода текста сообщения не пустое, а уже содержит текст 
исправляемого сообщения. Сохранение внесённых изменений производится по- 
следовательным нажатием кнопок Ргемем и Зибти. 

Во-вторых, модератор может удалить сообщение любого пользователя. 
Для этого предназначена кнопка Беве (Удалить). После нажатия на неё откры- 
вается страница с запросом подтверждения (рис. 8.15). 
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Рис. 8.15 
Запрос на подтверждение удаления сообщения 

Для окончательного удаления сообщения надо подтвердить принятое ре- 
шение с помощью кнопки Зибтй (Подтвердить). Если же кнопка Беве была 
нажата по ошибке, то можно отказаться от удаления с помощью кнопки Сапсе! 
(Отменить). Удалённое таким образом сообщение не исчезает из обсуждения, а 
остаётся в нём на прежнем месте (рис. 8.16), только текст сообщения заменяет- 
ся на фразу Вевеа (Удалено). 


= О х 
© тре этае-раде мезие: Рог Хо + 


< С О не защищено | 105$й.5егуег8081 /богитроз 7 8е8335е яж э 


тре зта!е-раде мезКе / гот Содоеня = обо 


= Ноте Тите!тпе Нез Вгапсвез 


СРгопоюдса! 


Графические элементы 
(1) Ву Мападег оп 2020-03-15 13:45:20 [пк] 


Элина Михайловна, как у вас дела с картинками для нашей странички? Скоро они понадобятся 
верстальщикам 


| Веру. 


(5) Ву Безюпег оп 2020-03-15 14:24:24 аз едиеа Бу Мападег оп 2020-03-16 09:59:56 [ипК] п геру © 1 
беееа 


| Веру, 


Рис. 8.16 


Удалённое сообщение остаётся в обсуждении на прежнем месте, 
только вместо его текста отображается Бев{еа 
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При эксплуатации системы Е05$Й сообщения будут поступать в разные 
темы обсуждений, и модератор может упустить из вида некоторые из них, в ре- 
зультате чего общение остановится. Чтобы увидеть сразу все сообщения, тре- 
бующие его внимания, модератор может воспользоваться пунктом раскрываю- 
щегося меню Аати!ганоп Радез | Репатда Модегайоп Ведиез{6 (рис. 8.17). 
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Рис. 8.17 
Переход к списку сообщений, ожидающих проверки модератором 
В появившемся списке легко перебрать все сообщения, просматривая их 
по гиперссылкам с идентификаторами (рис. 8.18) и одобряя или запрещая их 
публикацию. 
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Рис. 8.18 
Список сообщений, ожидающих проверки модератором 
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Глава 9 
СЕРВЕР 


9.1. Протокол передачи гипертекста 


Соединение компьютеров кабелем или с помощью волновых приёмо- 
передатчиков для обеспечения информационного обмена — важный, но далеко 
не решающий шаг в расширении сфер их применения. Для использования этой 
технической возможности требуется программное обеспечение, которое будет 
формировать информационные блоки для передачи и обрабатывать их при по- 
лучении, реализуя при этом какую-то полезную функцию, например, резервное 
копирование файлов или распространение новостных сообщений. 

Совокупность правил и соглашений, описывающих структуру блоков ин- 
формации, которые участвуют в информационном обмене, и порядок (регла- 
мент) такого обмена называются протоколом. Например, для передачи простых 
наборов данных между рядом стоящими компьютерами в локальной сети пред- 
назначен протокол Е®егпеф, для обмена такими наборами в сложной сети с про- 
межуточными станциями — маршрутизаторами — обычно используют прото- 
кол ГР. Чтобы адресовать пакет информации конкретной программе, выполня- 
ющейся на компьютере, применяют протокол ОШР, а для установления канала 
передачи данных между программами, выполняющимися на различных компь- 
ютерах, — протокол ТСР. 

Перечисленные протоколы решают сложную и важную задачу доставки 
блоков информации с одного компьютера на другой через не всегда надёжные 
линии связи, но их затруднительно использовать в прикладных целях. Напри- 
мер, чтобы записать файл на сервер, недостаточно передать содержащиеся в 
этом файле данные с одного компьютера на другой. Надо сначала определить 
сетевой адрес сервера по его имени, затем проверить, имеет ли пользователь 
право записи на сервер, а потом вместе с содержимым файла передать (и обра- 
ботать) его атрибуты. При использовании протоколов ОШР или ТСР для этого 
потребуется много отдельных информационных обменов, что непросто реали- 
зовать в программах, нуждающихся в передаче файлов. Поэтому были разрабо- 
таны протоколы более высокого уровня, например ЕТР, МЕ и $ЗМВ/СГЕ$, ис- 
пользующие протоколы ОШР и ТСР, но скрывающие сложность решения этой 
задачи. 

В конце 1980-х гг., когда сеть Интернет в виде обмена данными между 
компьютерами уже состоялась (например, в ней функционировали серверы 
обмена файлами ЕТР и передачи электронной почты ЗМТР/РОРЗ), Тим Бер- 
нерс Ли предложил протокол для размещения в этой сети гипертекстовой ин- 
формации — текстовых документов, связанных между собой перекрёстными 
ссылками. 

В результате в 1991 г. возникла всемирная паутина \\о4 УЛ де \еБ, ныне 
известная под аббревиатурой \/\/У,, которая базируется на двух китах — языке 
гипертекстовой разметки НТМГ (НурегТех{ Магкир Гапоиазе), на котором пи- 
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шутся текстовые документы для размещения в \/\У\,, и протоколе НТТР 
(НурегТехЕ ТгапзРег Ргоюсо!), предназначенном для обмена этими документами 
в сети Интернет. Протокол НТТР как соглашение о правилах информационного 
обмена используется двумя типами программ — веб-серверами, которые рабо- 
тают на компьютерах, хранящих гипертекстовые документы, и веб-браузерами, 
которые выполняются на компьютерах пользователей, запрашивают необходи- 
мые документы у серверов и отображают их содержимое на экранах. При пере- 
даче данных, как уже было сказано выше, неявно используются низкоуровневые 
протоколы ТСР, [Р, Ефегпеф, УМЕ (рис. 9.1). 


Е 


Рис. 9.1 
Передача гипертекстового документа от сервера к клиенту по протоколу НТТР. 
При этом неявно используются другие, более низкоуровневые протоколы 

Если низкоуровневые протоколы, поскольку они универсальны и требу- 
ются многим программам, реализуются модулями, входящими в состав опера- 
ционной системы, то высокоуровневые протоколы, предназначенные для реше- 
ния конкретных задач, реализуются теми прикладными программами, которым 
они необходимы. Оформление данных в соответствии с протоколом НТТР вы- 
полняется веб-сервером, а их интерпретация и распаковка — веб-браузером. 

Соглашения, входящие в состав протокола НТТР, описывают не только 
способы доставки документов от сервера к клиенту, но и передачу информации 
в обратном направлении — от клиента к серверу. Это позволяет реализовывать 
полноценные веб-приложения, принимающие и обрабатывающие пользователь- 
ский ввод и выдающие ответы на запросы пользователей. В полной мере воз- 
можности протокола реализуют такие специализированные веб-серверы, как 
АрасВе и пешх. В дополнение к базовой функциональности они умеют произ- 
водить авторизацию пользователей и формировать гипертекстовые документы 
на лету по программам, написанным на специальных языках программирова- 
ния, с использованием информации, хранящейся в базах данных. 
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Однако богатые возможности, заложенные в протокол НТТР, в полной 
мере используются далеко не всегда. Во многих случаях от веб-сервера требу- 
ется лишь выдать в ответ на запрос пользователя гипертекстовый документ, 
хранящийся в НТМГ-файле. Этого достаточно для реализации статического 
веб-сайта, раздающего редко изменяющуюся информацию. В таких случаях 
установка, а главное, настройка полноценного веб-сервера может быть совер- 
шенно лишней. Такую простую функциональность умеют реализовывать мно- 
гие программы, в число которых входит и Е0$$1. 


9.2. Язык разметки гипертекста 


Чтобы веб-браузеры могли правильно отображать содержимое гипертек- 
стовых документов и корректно обрабатывать содержащиеся в них гиперссыл- 
ки, текст документов должен быть оформлен в соответствии с правилами языка 
разметки гипертекста НТМГ. В настоящий момент актуальной является пятая 
версия этого языка разметки. Структура правильно оформленного НТМГ- 
документа выглядит следующим образом: 


Структура НТМГ-документа 


<!аосбуре ВЕп1> 
<рем1 1апад="ги"> 
<реаа> 
<тефа свагзее="аеЕ-8"> 
<Е11е>Шаблон НТМГ-документа</&1Е1е> 
</пеаа> 
<Боду> 
<р1>Шаблон НТМЬ-документа</51> 
<5есЕ1оп> 
<в2>Первая секция</62> 
<р>Содержимое первой секции.</р> 
</зесЕ1оп> 
<5есЕ1оп> 
<в2>Первая секция</62> 
<р>Содержимое первой секции.</р> 
</зесЕ1оп> 
</Боау> 
</вЕт1> 


Документ, соответствующий требованиям НТМТ.5, — это текстовый 
файл, обычно имеющий расширение „Би, в котором наряду с основным ин- 
формационным наполнением содержатся теги — специальные обозначения в 
угловых скобках, описывающие структуру документа. В настоящее время 
НТМЕ-документы обычно сохраняются в кодировке ОТЕ-8 (как правило, коди- 
ровку можно указать при сохранении текста в редакторе). Будем исходить 
именно из этого предположения, потому что в случае неправильной кодировки 
при просмотре документа в веб-браузере текст на русском языке может стать 
нечитаемым. 
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Первой в НТМГ-документе должна идти строка, декларирующая его тип: 
<Юосуре Мт!>. Она информирует веб-браузер о том, что в дальнейшем содер- 
жимое документа следует трактовать в соответствии с правилами НТМГ5. 

Собственно НТМГ-документ заключён в теги <Нит[> и </й#т|> и состоит из 
двух частей — заголовка, заключённого в теги <Пеаа> и </пеад>, и тела, заклю- 
чённого в теги <боду> и </боду>. В открывающем теге <И{т|> должен присут- 
ствовать атрибут {апе, указывающий, на каком языке написано содержимое до- 
кумента. В рассматриваемом примере значение ги этого атрибута указывает на 
русский язык. Участок документа, состоящий из открывающего и закрывающе- 
го тегов вместе с находящимся между ними содержимым, называется элемен- 
том НТМЕ. 

В заголовке документа обычно указывается служебная информация. 
В элементе <ШМе> записывается название документа, которое отображается на 
вкладке веб-браузера и используется в качестве одного из основных ориентиров 
поисковыми системами Интернет, такими как Яндекс или СооЗе. С помощью 
атрибута сБагзеё тега <теа> указывается, в какой кодировке представлен текст 
документа. Это важно для правильного отображения содержимого документа в 
веб-браузере. 

В теле документа находится его основное содержимое — та информация, 
которая должна быть отображена в веб-браузере и представлена пользователю. 
Обычно в самом начале тела документа находится заголовок верхнего уровня 
<11>, относящийся ко всему документу в целом. Информационное наполнение 
может быть разбито на несколько секций с помощью тегов <зесйоп> и </зесйоп>, 
внутри которых текст делится на абзацы с помощью тегов <р> и </р>. В соответ- 
ствии со стандартом НТМГ5 каждая секция должна иметь свой заголовок — 
в приведенном примере это заголовки второго уровня, представленные элемен- 
тами <П2>. 

Деление содержимого документа на секции не является обязательным, 
оно может быть представлено в теле документа непосредственно. Помимо сек- 
ций в языке НТМЕ имеются и другие возможности для организации содержи- 
мого в блоки с учётом его смысловой нагрузки (заголовки, подвалы) или без её 
учёта (подразделы). 

Начальные сведения о том, как с помощью НТМЕ изменять начертание 
текста, вставлять графические иллюстрации и создавать гиперссылки, приве- 
дены в разделе о системе документирования. Языку НТМГ, посвящено множе- 
ство учебников, в том числе информационно-справочных ресурсов в сети Ин- 
тернет, поэтому найти интересующую информацию не составит труда, а пред- 
ставленных в этой книге сведений достаточно для понимания дальнейшего ма- 
териала. 


9.3. Веб-сервер 


Для реализации дополнительной функции статического веб-сервера в 
Ео5$1 разработчикам не пришлось прилагать много усилий. Система Ео$$1 из- 
начально была ориентирована на использование веб-интерфейса в качестве од- 
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ного из основных средств управления репозиторием проекта и поэтому обязана 
уметь обрабатывать протокол НТТР. Возможность выдачи по этому протоколу 
НТМЕ-документов, содержащихся в отдельных файлах, стала приятным рас- 
ширением уже реализованной функциональности. 

Ранее был описан способ запуска Роз для предоставления доступа к се- 
тевому репозиторию, хранящемуся на сервере в файле ззрумебзНе.ю$$1, с помо- 
щью команды: 


Ео$$11 зекуек -Р 8081 ззрмерз1Ее.Ео$$11 


Но если в организации ведётся разработка нескольких проектов, то есте- 
ственной является потребность одновременной работы с несколькими репози- 
ториями. В этом случае файлы репозиториев можно собрать в одном каталоге, 
который называется, например, /маггероз, а затем предоставить к ним сетевой 
доступ командой: 


Ео3$11 зегуегк -Р 8081 /уак/героз 


После этого репозитории, хранящиеся в файлах гер1.10$$Й и гер2.ю5°1, 
станут доступны по гиперссылкам П#р:/Мо$$1.зегуег:8081/тер1 и ИНр:/Мо$$1.зегуег: 
8081/ер2 соответственно, в которых Ю3$$1.зегиег — это сетевой адрес сервера 
Ео5$1. Таким образом, один сервер может обслуживать любое количество репо- 
зиториев. 

Но что произойдёт, если попытаться обратиться к такому многорепози- 
торному серверу по гиперссылке Пр:/Моз$1.зегуег:8081/, без указания имени кон- 
кретного репозитория? В этом случае сервер Ео$$1 ответит «М 1 Гоип4» и вернёт 
ошибку 404 — запрошенный ресурс не найден. Так отвечают веб-серверы, когда 
к ним обращаются по неправильным гиперссылкам. 

Можно сделать так, чтобы при обращении к серверу Ео$$И без указания 
имени репозитория пользователю возвращался список репозиториев, обслужи- 
ваемых сервером, с возможностью выбора одного из них для дальнейшей рабо- 
ты (рис. 9.2). Для этого достаточно добавить параметр --герой5! в команду за- 
пуска сервера: 


Еоз$11 зегуег -Р 8081 --геро113Е /уак/кероз/ 


Это, безусловно, полезная функция, но от веб-сервера ожидают большего. 
Как минимум он должен возвращать по запросу файлы, составляющие веб- 
страницу. Обычно речь идёт о файлах, имеющих расширение: 

® т|— содержимое веб-страницы, оформленное на языке разметки 
НТМГ; 

® .с55 — таблицы стилей, записанные на языке С$5; 

® |3 — исходные тексты сценариев на языке ЛауаЗспре 

® 01, |р9, -рпд— файлы с изображениями для иллюстрирования веб- 
страницы. 
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© верозйогу = х + 


С О не защищено | №5$й.5егуег 8081 ж о : 


Ко$$Й ВКеро$Ноте$ 


Е|епаше Ргоуесй Маше Газ Мо@#еа 
гер1 05311 Система финансового анализа 1.6 Воитз 
гер2. 05311 Система бизнес-планирования 1.6 Воштз 
ззрухебзие 03511 Знир[е 311[е-расе \хебзие 3.2 дауз 
Рис. 9.2 


Сервер Ео55Й умеет формировать список 
обслуживаемых им репозиториев 


В простом текстовом редакторе наберём текст НТМГ-странички и сохра- 
ним его в файле таех.Мт! в кодировке ОТЕ-8 (обычно текстовый редактор 
предлагает выбрать кодировку при сохранении): 


Файл таех ит! для стартовой страницы сервера Ео55И 


<!аосЕуре ВЕп1> 
псп 1апа="га"> 


< 
< 
<пеба стагхзеф="аеЕ-8"> 
<Е151е>Сервер Еоз311</&1Е1е> 
</пеаа> 

< 

< 


1>Корпоративный сервер Еоз$11</61> 

<в2>Обслуживаемые репозитории:</62> 

<и1> 

<11><а ргеЕ="/ззриерз1ее">Одностраничный веб-сайт</а></11> 
<11><а ргеЕ="/гер1">Система бизнес-планирования</а></11> 
<11><а ргеЕ="/гер2">Система финансового анализа</а></11> 
</и1> 

</Боау> 

</ВЕт1> 


Поместим созданный файл таех.Н{т! в каталог А/а/героз, где уже находят- 
ся файлы гер1 10$$1 и гер2.40$5Й, после чего запустим веб-браузер и наберём в 
адресной строке: ПНр:/Моз$1.зегуег:8081Лпаех.Нёт!. Получим ту же самую ошибку 
Мо! оипа, сообщающую о недоступности запрошенного файла. 

Дело в том, что по умолчанию веб-сервер Ео5$1 настроен на обслужива- 
ние исключительно файлов с расширением 531, в которых хранятся репозито- 
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рии. Чтобы он стал замечать файлы с другими расширениями, надо в команде 
запуска сервера перечислить шаблоны имён этих файлов в параметре --1ех: 


Е05$11 зегуег -Р 8081 --Е11ез *.В,*.сз5,*.)$,*.)ра,*.91Е,*.рпа /хаг/героз/ 


После этого веб-сервер станет отвечать по указанному выше адресу со- 
зданной веб-страницей (рис. 9.3). 


— О х 
© сервер РО$51 х + 


— С О не защищено | №0$$1.5егуег:8081 /паех.Внт! 3% в : 


Корпоративный сервер КОУУП, 


Обслуживаемые репозитории: 


® Одностраничный веб-сайт 
® Система бизнес-планирования 
® Система финансового анализа 


Рис. 9.3 
Веб-сервер возвращает файл таех.Шт/ расположенный в каталоге 
вместе с файлами репозиториев 
Можно пойти дальше и создать на сервере в каталоге /иаг/героз подкаталог 
мебзце, который сделать рабочим каталогом для разрабатываемого веб-сайта: 


пКа1к /уаг/героз/мебз1фе 
са /уаг/героз/мебз1ее 
Ео$5$11 ореп ../ззрмерз1е.Еоз$11 "основная" 


После этого по адресу Нйр:/М№оз$1.зегуег:8081ЛмебзНйеЛпаех.тт! будет от- 
крываться веб-страничка, разрабатываемая в рамках проекта «Простой одно- 
страничный веб-сайт». Необходимость указания в последней команде названия 
ветви «основная» возникла по той причине, что главная ветвь разработки, по 
умолчанию называемая тапК, была переименована в приведенном ранее при- 
мере. 

С одной стороны, это позволяет разработчикам оценить разрабатываемый 
веб-сайт в действии. С другой, система Еоз5Й начинает выступать в роли систе- 
мы доставки содержимого на сервер и своеобразной системы управления со- 
держимым — СМ$. Осталось на сервере организовать периодическое выполне- 
ние команды обновления рабочего каталога (например, с помощью входящего в 
операционную систему планировщика): 


Еоз$11 срескойе 1асезе ГЕОС 
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@® тре эпае-раде мебзйе х + 
< С О незащищено | +ю05$й.5егуег:8081 ЛмеБ$Иеипдех. Вт! х ©@ 
Сотрапу ЗесНоп 1 Зес#оп 2 Зес#оп 3 ЗесНоп 4 
Еогет 
1рзит 4оюг 
$Й ат 


Сотрапу 


[огет 1рзит 4900г $й атё 
сопзееиг афрзста ей, зе9 до 
ешизтод {етрог псаип{ и{ |абоге еЁ 
ооге тадпа айаиа. \\ епт аа 
пит уетат, 9и5 поз{гиа 
ехегсцайоп иЙ!атсо |абоп5 п ш 
айашр ех еа сотто4о сопзедиа Ошз аще гиге доюг п гергепепдет т 
уоирае уе! еззе сШит до!оге еи гида пийа рапаиг Ехсереиг $ 
оссаеса{ сир4айа{ поп ргоеп, зип п сшра аш ойаа дезегип{ то! апит 
14 е{ 1абогит. 


Рис. 9.4 
Сервер Ео55И предоставляет доступ к веб-сайту, 
построенному из содержимого репозитория одного из проектов 

Тогда в рабочем каталоге веб-сайта на сервере будут находиться автома- 
тически обновляемые версии файлов проекта, куда будут попадать все вноси- 
мые разработчиками и отправляемые в репозиторий изменения. Такой вариант 
использования может представлять интерес для организации функционирова- 
ния корпоративного веб-сайта. Помимо регулярных обновлений он позволяет в 
любой момент восстановить любую историческую версию содержимого сайта 
из своего репозитория. 

Если зайти на официальный сайт системы Е0551 И{рз://о$$-$ст.ога/, кото- 
рый работает под управлением этой же системы (самой актуальной её версии), 
то можно заметить его более богатое оформление (рис. 9.5) по сравнению с веб- 
интерфейсом репозитория, рассматриваемого в этой книге. Прежде всего бро- 
саются в глаза информативная стартовая страница Ноте и изменённое главное 
меню, которое содержит нестандартные пункты: 00с$ — для перехода к страни- 
це сопроводительной документации, Соде — для просмотра последних версий 
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файлов проекта, Зиррой — для перехода на страницу форума — и Вомпоаа — 


для скачивания дистрибутивов системы Е0$5$1. 


$ Роз5: Ноте х - 


< {© 


@ 10551-5ст.огд/поте/Чос/гипК/млмм пех мик! 


Ро$$! / ноте 


= Ноте Титете Вос Соде Зиррой 


\М!Па+ 1$ Ро$$Й? 


Рой 15 а эитре, пюп-гейаыйу, а1иЬщед зоймаге 
сопйдигавоп тападетег{ зуз{ет мА {Пезе адуапсед {теашгез: 


1. Имедгаеа Вид Тгаскта, УМК, Рогит, апа Тесппо{е$ - 
|п адаоп {о дотд 9451 пЬщед уегэоп сопго! Ше СЁ апа 
Мегсипа!, ГоззЙ ао зиррой$ Бид {гасктад, мик, гогит, 
апа {есппо{ез. 


Оомпюаа 


Бомпюад 
Ошск Зап 
пай 
Зирро/Рогит 
Прз & Ни 


Спапде 109 

Исепзе 

Узег ИпкК$ 

Наскег Ном-То 
Роз5й м5. СИ 
Ооситетайоп шадех 


2. Вши-т Меь Имегасе - Го$$Й Ваз а Би -т, ПетеаЫе, 
апа ицифуе меб и{еПасе миИ а псй уапейу о! пюгтайоп 
радез (ехатр!ез) рготойпд зЙйиайопа! амагепез$. 


ТЬ5 епёге ммебзйе 1$ }и5{ а гипптд пзапсе о! Роз$й. Тре 
радез уси зее Пеге аге а! \мК! ог етБедаед 
доситетайоп ог (т {Пе сазе о {пе домипюад раде) 
ипуегэюопед #1ез. \МПеп уси сюпе Ро$$й от опе о! И5 
зеН-позйпа герозЙопез, уси де{ тоге {пап ]и${ зоигсе 
соде - уси де! {115 епёге мезке. 


© 


 ч 
7.4 
` 

“а 


3. $еН-Согматеч - Роз {5 а эпае зеН-согиатед ${апа- 
аюпе ехесщаЫе. То п${а!й, эитр!у домипюад а 
ргесотрйед Ыпагу Фог Ипих, Мас, ог \МИпдом5 апа ри й 
оп уочг $РАТН. Еазу-{ю-сотрйе оигсе соде 15 а5о 
ауайаЫе. 


4. $тр!е МемогКт9 - Мо сизот ргоюсо[$ ог ТСР рой. Ео$$1 изез ог4тагу НТТР (ог НТТР$ 
ог 55Н) {ог пемо к соттипкавоп$з, 50 Й ммогК$ йпе Яот Бемпа гез{псвуе Яге\мма!з, паидтад 
ргожез. Тйе ргоюсо! 15 Бапамлй етаеп( {о {пе рот {Па{ Ро$$й сап Бе изед сопоцаЫу оуег 
а|-ир ог оуег {Пе ехсеедтау э1о\и \МЯ оп атегз. 


Рис. 9.5 
Главная страница официального веб-сайта проекта Ео55 
Попытаемся улучшить веб-интерфейс нашего репозитория. 


9.4. Встроенная документация 


Ранее была рассмотрена система документирования Е0$$1, которая позво- 
ляет вести информационные странички со статьями, посвящёнными различным 
аспектам разрабатываемого проекта и оформленные с помощью языков размет- 
ки УИ или МагКдо\п. Помимо этого Ео$5 даёт возможность использовать в 
качестве страниц документации файлы, являющиеся частью проекта и находя- 
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щиеся в его рабочем каталоге. Такой вариант документирования имеет следую- 
щие преимущества: 

® версия документации всегда соответствует версии разрабатываемого 
проекта и может быть выгружена вместе с его исходными текстами в одном ар- 
хиве; 

® для редактирования файлов, содержащих страницы документации, 
можно использовать любой текстовый редактор или привычную среду разра- 
ботки; 

® вносить изменения в документацию могут только участники проекта, 
имеющие права разработчиков (иногда это может быть и недостатком). 


9.4.1. Работа над документацией 


Вернёмся к примеру разработки шаблона одностраничного веб-сайта. 
Предположим, что работу над документацией менеджер решил вести в отдель- 
ной ветви проекта. Поскольку для неё не требуются никакие наработки из ис- 
ходных файлов проекта, в качестве основы этой ветви менеджер решил исполь- 
зовать начальную точку сохранения репозитория, соответствующую пустому 
моментальному снимку рабочего каталога. Идентификатор этой точки сохране- 
ния — 24е23с5с®, поэтому команда создания ветви «документация» приобрела 
такой вид: 


Еозз11 Югапсб пем "документация" 24е23с5сЕБ 


Команда завершилась без ошибок: 


Меми БРгапсВЬ: 
30ссЕбая616630Еа9се8а9765049487е0Еа2а656Ее2е42а346Е8а5957а3с39ба 
Апбозупс: ВЕЪр: / /Марадег@Еоз$11.зегуег:8081/ 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 1 гесе1уеа: 0 

Ризр аопе, зепе: 909 геселуеЯ: 281 1р: 192.168.56.101 


Для файлов с документацией менеджер создал отдельный пустой каталог 
аоситеп" (за пределами рабочего каталога с файлами исходных текстов шаблона 
одностраничного веб-сайта), сделал его текущим и открыл из него только что 
созданную ветвь «документация». Всё перечисленное он выполнил с помощью 
последовательности команд: 

"ее 

шка1к ЧАосамепе 

са Яосчмепе 

Еозз11 ореп ..\ззриерз1ее-1оса1.ЁЕоз511 "документация" 


Таким образом, у менеджера появился рабочий каталог, ассоциированный 
с ветвью «документация»: 


рго]есЕе-паме: $1тр1е °1п91е-раде мерз1е 

тероз1фогу: .../Мападек/аоситере/..\ззриерз1Ее-1оса1.ЁЕо$3$11 
1оса1-коо®: .../Мападег/аосимепте/ 

сопЕ19-9: С:/Озегз/РСОзег/Арррафа/Тоса1/ 05511 
рго]десе-соае: 53е4е1445Ер2а7289е51а337се1сЕ8с9а99Е7Ъ86 
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срескоце: З0ссЕбаа616630ЕЕа9се8а9765049487е0Еа2а656 2020-05-22 
18:11:38 ОТС 

рагеп®: 24е23с5сЕБЮБа7Ье781аба8©бе7аас8е12е9сас4 2020-02-29 
07:24:50 ОТС 

Сачз: документация 

соптепе: Сгеаее пем Бгапср памеЯ "документация" (изег: Мападег) 
среск-1п3: 40 


В этом рабочем каталоге менеджер создал подкаталог ммм, а в нём — три 
текстовых файла таех.та, сощет.та и $Уе.та в кодировке ОТЕ-8, содержащих 
информационные страницы, оформленные с помощью разметки МагК4о\уп. 


Листинг файла таех.та 


ростой одностраничный веб-сайт 


ростой одностраничный веб-сайт 


Этот проект посвящён разработке шаблона простого одностраничного веб-сайта, 
который может быть использован для быстрого создания сайта-визитки. 


Ключевыми особенностями проекта являются: 


х следование веб-стандартам; 
* использование свободных средств разработки; 
* открытая лицензия. 


Дополнительные сведения: 


[Информационное наполнение] ($ВООТ/аос/$СОВВЕМТ/мим/ сопеепе.ма) 
* [Стилевое оформление] ($ВООТ/аос/$СОВВЕМТ/мии/ зЕу1е.та) 


Обсуждени роекта ведётся [на форуме] ($ВООТ/Еогим). 


Листинг файла сотет.та 


Информационное наполнение 


Информационное наполнение 


Одностраничный веб-сайт состоит из заголовка, подвала и основного 
содержимого, редставленного информационными блоками. Каждый блок 
содержит иллюстрацию и текст, которые чередуются в шахматном по- 
рядке: у нечётных блоков иллюстрация располагается справа от тек- 
ста, а у нечётных слева. 


В заголовке расположено меню, пункты которого являются гиперссыл- 
ками на якоря, представленные заголовками информационных блоков. 
При выборе пункта меню происходит прокручивание страницы к содер- 
жимому выбранного информационного блока. 
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[Назад] ($ВООТ/Вопе) 


Листинг файла зе.та 


Стилевое оформление веб-странички 


Стилевое оформление веб-странички 


Правила оформления веб-странички находятся в файле 1п4ех.с$5_. 


Чтобы веб-странички одинаково отображались в различных веб- 
браузерах, первоначально производится обнуление значений полей и 
отступов для всех элементов: 


* {пага1п: 0; рааа1та: 0} 


Тексту документа назначается основной шрифт, размер которого при- 
нимается за базовый. Размеры шрифтов остальных элементов веб- 
странички задаются в относительных единицах, благодаря чему они 
будут изменяться пропорционально изменению размеру базового шриф- 
та. 


роау {ЕопЕ: погма1 погма1 погща1 100% запз-зег1 Е} 


Центрирование блочных элементов по торизонтали осуществляется с 
помощью риёма, устанавливающего автоматические значения полей 
слева и справа от центрируемого элемента: 


.сепеег {щагд1п-1еЁ®: айбо; мага1п-х19Ве: аиво} 


[Назад] ($ВООТ/Воме) 
Менеджер добавил созданные файлы в список системы контроля версий С 
помощью команды: 


Ео$$11 ааа ммм 


Команда сообщила об успешном выполнении: 


АБОЕО мим/сопеепе .па 
АБОЕР мим/1паех.па 
АРРЕР мим/ зе у1е.тма 


После этого менеджер загрузил эти файлы в репозиторий командой: 


05511 соши16 -м "Добавлены исходные варианты файлов сопроводи- 
тельной документации" 
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Команда завершилась без ошибок: 


Апбозупс: ВЕ: / /Мападег@Еоз$11.зегуег :8081/ 

Воипа-Ег1рз: 1 АкЕ1Еасёе5 зепёе: 0 гкеселуеа: 0 

Ра11 аопе, зепе: 520 геселуеа: 561 1р: 192.168.56.101 
Мем_Уег51оп: 
407ес7Ь25а56а6с8494а40485830621сс2Е90947а8604244144е8 991593 с5ааб6 
Апбозурпс: ВЕ: / /Мападег@Ео$$11.зегуег : 8081/ 

Воппа-Ег1рз: 1 АкгЕ1Еас®5 зепе: 4 гесе1уеа: 0 

Зупс аопе, зепе: 2555 геселуеа: 707 1р: 192.168.56.101 


9.4.2. Использование документации 


Теперь сопроводительная документация находится в репозитории. Чтобы 
убедиться в этом, достаточно в адресной строке веб-браузера набрать: 


ВЕЕр://Е0$511.зекуег : 8081 /аос/документация/ими/1паех.ма 


Должна отобразиться страничка, показанная на рисунке 9.6. 


к 


— | х 
@® тре 5то-раде мебзие: Про Хх + 


< - С О не защищено | $05$.5егуег:8081/дос/документация/мимм/паехтла = 


эитр!е зтае-раде мезКе / 
Простой одностраничный веб-сайт 
Мападег — 1одош 


— Ноте тете Ее Вгапспез Озегз 


Простой одностраничный веб-сайт 


Этот проект посвящён разработке шаблона простого одностраничного веб-сайта, который 
может быть использован для быстрого создания сайта-визитки 


Ключевыми особенностями проекта являются 
» следование веб-стандартам; 
® использование свободных средств разработки 
® открытая лицензия 


Дополнительные сведения: 


®» Информационное наполнение 
® Стилевое оформление 


Обсуждение проекта ведётся на форуме 


Рис. 9.6 
Отображение страницы встроенной документации проекта 
Разберём адресную строку подробно (рис. 9.7). Начало у неё традицион- 
ное: И#р:/Мо$$1.зегуег:8081 — это протокол, сетевое имя сервера и номер ТСР- 
порта, на котором ожидает сетевых подключений сервер Ео$$1. Средняя часть 
адреса /аос/документация задаёт ссылку на точку сохранения «документация» 
(как мы помним, имя ветви эквивалентно идентификатору самой поздней точки 
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сохранения на ней) и требование интерпретировать заключительную часть ад- 
реса в качестве пути в моментальном снимке рабочего каталога к файлу встро- 
енной документации: Амм\мЛпаех.та. 


В р:/№о$$Й.5егуег:8081/4ос/документация/Ммли\мИптдех.та 


документация 


содержимое 


Рис. 9.7 
Соответствие элементов адресной строки сущностям системы Ео55И: веб-серверу, 
ветви репозитория и пути к файлу относительно моментального снимка 

Веб-сервер Еоз5Й обрабатывает эту адресную строку и возвращает брау- 
зеру веб-страницу, сгенерированную с использованием содержимого файла 
пдех.та. При этой обработке первый заголовок из файла документации исполь- 
зуется в качестве подзаголовка репозитория и отображается над строкой главно- 
го меню. Поэтому в файле документации первые заголовки продублированы. 

В файлах документации имеются гиперссылки на внутренние элементы ре- 
позитория — на другие файлы документации и на стартовую страницу. Для уни- 
версальности в этих ссылках используются переменные $ВООТ и $СУВВЕМТ. При 
подготовке веб-страниц системой Е0о$$1 эти переменные заменяются на сетевой 
адрес репозитория и на имя текущей ветви репозитория соответственно. 

Чтобы установить страницу встроенной документации в качестве старто- 
вой страницы репозитория, надо завершить процедуру его настройки, начатую 
ещё в процессе его создания. Для этого придётся авторизоваться в системе под 
именем пользователя — владельца ЗеирОзег (прав администратора репозитория 
недостаточно) и воспользоваться пунктом меню Адтт | Сопйдиганоп (рис. 9.8). 


— | х 
@ тре эпае-раде меб зе: бег Х = 


х @ 


< С О нНезащищено | +0$5,5егуег:8081/зеёир 


эитр!е зэтае-раде меь$Ке / зегег датитьканоп 


% ЗешрИзег — [090 


= Ноте тете ЕИе$ Вгапсйез Адти 
Озегз Сгаг{ рим!едез 10 памача! изегз. 
Ассезз Согиго| ассез$ зе пд$ 
Сопйдиге {пе М/ИЛ// сотропег(з оГ1Не герозйогу 
Зесищу-Аиди Апа!уге Ве сштег{ сопйдигайоп 1ог зесищу ргоМетз 
Зетаз \\МеБ име[асе {о {Пе "№0551 зе тпд$" соттапа ” 


Рис. 9.8 
Переход к настройке репозитория 
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На открывшейся форме надо внести адрес требуемой страницы докумен- 
тации в поле паех Раде (рис. 9.9). После этого назначенная страница будет по- 
казываться при запуске веб-интерфейса репозитория и при выборе пункта меню 
Ноте. 


© тре эпаЕ-раде мебзие: ММ х + 


= (С О не защищено | 4055й.5егуег8081/5ейир_сопйд * © 
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ЗешрОзег — 10901 


= Ноте ТПтетпе [ез$ Вгапсвез Ади 


` Арру Спапдез | 


| тре это!е-раде мебзйе | Рго]ес* Мате 


Простой одностраничный веб-сайт. 
2 Ргоес{ БезсйоНоп 


[ззрмебзйе | ТагБай апа 21Р-агсме Ргейх 
итиоК | роммтюа@ Тая 
/4ос/документация/млмм/Лт4ех.т4 | пех Раде 


| Зоситегайоп шпаех (Ргорейу: зйетар-досвах) 
| Оомлтюаа (Ргорепу: зйетар-до\ипюад) 

| Исепзе (Ргорейпу: зИетар-йсепзе) 

| Сотас+ (Ргорепу: зйетар-сог(ас!) 


Арру и 


Рис. 9.9 


Указание адреса встроенной страницы документации для использования 
в качестве стартовой страницы репозитория 


9.5. Темы оформления 


Система Е0$5 позволяет в широких пределах настраивать оформление 
веб-интерфейса, изменяя цветовые схемы, шрифты, местоположение и состав 
интерфейсных элементов. Всё это реализуется с помощью тем — совокупно- 
стей шаблонов веб-страниц и таблиц стилей. В поставку Е05$ помимо основ- 
ной темы входят ещё двенадцать предварительно настроенных тем. 


9.5.1. Настройка темы 


Для переключения темы оформления надо в адресной строке веб-браузера 
набрать: ВИр:/№$$1.зег\/ег:8081/зейир_$Кт_аатт. Откроется страничка со списком 
предустановленных тем (рис. 9.10). Текущая тема обозначена надписью 
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Ситепйу ш Узе (Используется сейчас). Активация требуемой темы производится 
нажатием кнопки ш$ай, расположенной справа от её наименования. 


© 5тоЕ этаЕ-раде мебзИе: ки Х + 


= С О не защищено | №05$Й.5егуег:8081/5{ир_5Кип_адгип 


тре зэтае-раде меб з$Ке / эк: 


Ноте Ттетпе Ее Вгапспе$ Изег$ 


ВшЁ-т $К!п$: 


Бега! Сипепйу шп Цзе) 
Ви Тофа! 


Ви, Мо 1040 Газа 
Вос гар Тпа1ай 
Хекп 

Опата! 
ЕпВапсед Опапа! 


1. 
2: 
3. 
4. 
5. 
6. 
г 
8. 


Эвадоми Бохез & Коипдед Согпег$ 


© 


Еаде 
. Васк & МШ\це, Мепи оп ей 
Рат Сгау, Мо 1одо 
‚ Крак, № 1090 раза 
. Агдозе Гоа! 


= — 
и 


= = 
о 


Рис. 9.10 
Страничка управления темами оформления веб-интерфейса Ео55 

Например, в результате активации темы КваК, № Ё0од90 веб-интерфейс 
приобретает вид, показанный на рисунке 9.11. Если по какой-либо причине вы- 
бранная тема не приглянулась (например, в теме КпакК! из главного меню исчез 
пункт вызова раскрывающегося меню), то для возврата к исходной теме надо 
перейти на страничку со списком тем, как было описано выше, и активировать 
первую тему Беаи!. 

Дополнительную гибкость интерфейсу Еоз$1 придаёт возможность редак- 
тирования шаблонов веб-страниц и их стилей. Для перехода к настройке интер- 
фейса надо выбрать в раскрывающемся меню пункт Адтитхганоп радез, после 
чего перейти по гиперссылке ЗКтз (рис. 9.12). 
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@® $тьоЕ эпае-раде мебзие: Ре Хх + 


СО не защищено | 105$1,5егуег8 081 Агее?с=основная ж [= 


ЕНе 1151 Зипре этое-раде мебзИе 


Ноте ТтеНпе ЕИез Вгапснез Тая Рогит 'Иске{ Ук Озегз Годош 


АН Ре Аде$ Пр Ттее-Мем 


ЕНез ог спеск-т [5е33305Ъес] т {пе {ор-еуе! атес{юогу 
5 падез В ЫСЕМЗЕ С паех с5$ Г пдех нат! 


Рой 2.10 [999е 82234] 2019-10-04 21:41:13 


Рис. 9.11 
Веб-интерфейс с активной темой Квак! 


© тре эпае-раде меБзйе: бег х ++ 


< - С О не защищено | +055й.5егуег8081/&йир хх ©: 


Зипр!е этае-раде меь$Ке / зегег датитьнайоп 


Мападег — 1одош 


Ноте Титейпе Ее; Вгапспез Озегх 


®» Ноте Раде ® [0дош 
» Ре Вго\музег © Спапде Раззмуога 
© Гтее-ме\м, Тгипк Спеск-т ®» Керозйогу З{а$ 
о Наёмем © Со!зоп$ оп Вазв ргейхез 
о Ее адез №юг Тгипк о 1151 оГИРЕ$ изед {0 ассез$ {#15 


© Ипуегзюпеа ЕИез герозйо! 
* Ропит . 

о Кесег{ асйуцу о Репатд Модегайоп ВКедиез{5 
® Пскеб о Адти | 


Озегз Сгапримйедез 10 пдмача! изегз. 
Зесийу-Аидй Апауге Ве ситеп сопйдигаНоп ог зесийу ргоМетз 
Тте!ше Титейпе 91зр!ау рге{егепсез 
Зеагсп Сопйдуге Пе Бий-т зеагсй епате 


ОВЕ Аназез Сопйдиге ОР айазез 
= Заес! апа/ог тодйу {пе ме имегасе "зКпз" 


Модегайоп Епае/ОзаЫе гедиипд тодегаюг арргоуа! о! \/К! апа/ог Тиске{ свапдез апа 
аНасптеп!5. 


Рис. 9.12 
Переход к настройке интерфейса 


Откроется страница, на которой процедура редактирования темы оформ- 
ления представлена в виде восьми шагов. Вносить изменения прямо в активную 
тему нельзя. Поэтому на первом шаге предлагается выбрать один из девяти сло- 
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тов-черновиков, в которых будут сохраняться выполненные изменения 
(рис. 9.13). 


_ О х 
@ этрЕ эпае-раде мебзйе: Сие Хх + 


< С А Не защищено | #05$1.5егуег:8081/зетир_5Кип х @ 


эитпр!е зтае-раде мер $Ке / сьзютге эп малады — одом 


= Ноте Титете Ее Вгапспез Узегх 


З{ер 1: еп Йу \Мусп Огай То Узе 
Огай зКил 10 ей 
З{ер 2: Ашпеписае 


Ацпопгед едйогз Гог Киз дгай1: | Оездпег Пе 


Зер 3: пша!хе Тпе Огай 
1пиайхе зКт агаЯМ изто | Оеаий (Буй-т) У || = 


З{ер 4: Маке ЕЧИ$ 


ЕдЧИ {Пе сотропеп!з о {Пе дгаЙ1 зКтп 


®» Росег 
®е Овай$ 
® ауазспри (орйопа!) 


Рис. 9.13 
Первые четыре шага настройки темы оформления 

Если настройкой занимается администратор системы, то на втором шаге 
предоставляется возможность перечислить через запятую имена учётных запи- 
сей пользователей системы Ео5$$1, которые будут иметь доступ к редактирова- 
нию выбранного черновика. Ввод пользователей надо завершить нажатием 
кнопки Свапде. 

Если работает авторизованный администратором пользователь, то ему со- 
общается о наличии разрешения на редактирование и предлагается перейти к 
следующему шагу. Если же текущий пользователь не авторизован, то ему реко- 
мендуется обратиться к администратору. 

На третьем шаге можно выбрать одну из предустановленных тем или дру- 
гой черновик для использования в качестве основы создаваемой темы. Вариант 
Сипепну шт зе (Используется сейчас) соответствует активной теме веб- 
интерфейса. Смену темы надо подтвердить нажатием кнопки Со. 

На четвёртом шаге предлагается заняться собственно редактированием 
стилей и шаблонов страниц. Для перехода в режим редактирования можно ис- 
пользовать одну из гиперссылок: 

® С35 — редактирование таблицы стилей; 

® Неадег — редактирование заголовка страниц; 

® Гооег — редактирование подвала страниц; 
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® Ое{а!$ — редактирование настроек; 
® /ауазсир! — редактирование сценариев ЛауаЗспре. 


Поскольку этот пункт является ключевым во всём процессе, рассмотрим 


его подробнее. 


9.5.2. Редактирование шаблонов 


Шаблоны веб-страниц Е0о$5$Й представляют собой НТМГ-код с встроен- 
ными сценариями на языке ТН], который является минималистичной реализа- 
цией языка сценариев Тс]. Текст сценариев заключается в теги <ТН1> ... </ТН1>. 

Чтобы изменить главное меню веб-интерфейса, надо подправить шаблон 
заголовка страниц, для чего следует воспользоваться гиперссылкой Неадег. От- 
кроется страница с редактором кода заголовка (рис. 9.14). На этой странице под 
главным меню имеется дополнительное меню, которое позволяет переключать- 
ся между редактируемыми элементами шаблона, что избавляет от необходимо- 


сти возвращаться в окно настроек шаблона со списком гиперссылок. 


— О 
@ тре эпае-раде мебзйе: Си Хх © 9УтрЕ зпае-раде мебзИе: Рас Хх + 


С О незащищено | Ф0551,5егуег8081/ефир_5Ктедй?м=28к=1 я © 


зипр!е этае-раде ме з$Ке / ргое неадег лог гай 


Мападег — 1090 


= Ноте тете ЕИе$ Вгапсвез$ ег 


С$$ Ое{ай$ Рос\ег Неадег Эспри 


ЕдИ Раде Неааег Тог Огай1: 


2+ {[Гапусар дог]} { 
тепи1 ЗК /#те13пе {Шкала времени} { } 
} 
3+ {[пазсар оН]} { ы 
тепи]$пК /43г?с1=ОоСсновная Файлы дезКороп1у 


3 


} 
{+ {[Вазсар о]} { 
тепи1$1к /Бг115& Ветви дезКкороп1у 
тепи]$1К /+аё115+ ЯРЛЫКИ и1деоп1у 


| Арру Свапдез к 


Вазе!те: | Ситепйу п Узе У || Упйед ОИ || $4е-Бу-Эе ОШ | 


х 


Рис. 9.14 
Страница редактирования шаблона заголовка 


Поскольку состав меню зависит от прав пользователя, работающего с веб- 
интерфейсом, оно реализовано в виде сценария. Элементы меню описываются 


условными конструкциями вида: 
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Е 


ЕНИЯ]} { 
ЕКСТ СТИЛЬ 


1Е {[Тазсар РАЗРЕП 
пепа110Кк АДРЕС 1 


г 


} 


1Е {[апусар РАЗРЕШЕНИЯ] } { 
пепо11пКк АДРЕС ТЕКСТ СТИЛЬ 


Операторы # проверяют наличие у текущего пользователя необходимых 
для доступа к пункту меню разрешений. Выражение Вазсар РАЗРЕШЕНИЯ явля- 
ется истинным, если у пользователя имеются все разрешения, представленные 
символами, входящими в строку РАЗРЕШЕНИЯ. Выражение апусар РАЗРЕШЕ- 
НИЯ является истинным, если у пользователя есть хотя бы одно разрешение, 
представленное входящим в строку РАЗРЕШЕНИЯ символом. Пункт меню, зада- 
ваемый оператором тепи К, добавляется в меню только в том случае, если со- 
ответствующее ему проверяемое условие истинно. 

В операторе тепцк АДРЕС ТЕКСТ СТИЛЬ параметр АДРЕС — это адрес 
страницы веб-интерфейса, соответствующей пункту меню, ТЕКСТ — это текст, 
который будет отображаться в соответствующей позиции меню, а СТИЛЬ — это 
С$5-стиль, который применяется к пункту меню. Стили ммаеоту и дезКюроту 
определяются в медиазапросах С$$, проверяющих ширину окна веб-браузера, и 
при недостаточной её величине скрывают своё содержимое. Можно указать пу- 
стое значение стиля в виде { }. 

Можно, например, русифицировать главное меню, заменив текст его 
пунктов следующим образом: Ноте — Старт, Тите!те — Шкала времени, Е!ез — 
Файлы, Вгапспез — Ветви, Тад$ — Ярлыки, РГогит — Форум, Тске5 — Заявки, 
МК! — Документы, Аатт — Настройка, Узег$ — Пользователи. Поскольку текст 
Шкала времени состоит из двух слов, в операторе тепиПК его надо заключить 
в фигурные скобки: 


пепи110Кк /&1ме110е {Шкала времени} {} 


Чтобы файловый обозреватель всегда открывался на основной ветви про- 
екта, а не на той, в которой позже всех была создана точка сохранения, в каче- 
стве адреса для пункта меню Файлы вместо /Аи?о=!р надо указать 
/Аг?с=основная: 


пепо11пКк /Я1г?с1=основная Файлы ЧезКЕороп1у 


После корректировки шаблона надо нажать на страничке редактирования 
заголовка кнопку Арру Свапдез. Можно сравнить исправленный шаблон с ис- 
ходным или шаблоном из другой темы. Для этого надо в поле Вазе!те (Основа) 
выбрать интересующую тему и нажать кнопку Уп\еа ОМ. Внизу страницы 
отобразятся имеющиеся различия (рис. 9.15). 
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Рис. 9.15 
Просмотр различий между изменённым и исходным шаблонами 


После фиксации изменений в черновике рядом с кнопкой Арру Свапдез 
появляется кнопка Веуец То "сите{", которая позволяет вернуть редактируемый 
шаблон к исходному виду. 


9.5.3. Использование темы 


Продолжим рассмотрение процедуры настройки веб-интерфейса 
(рис. 9.16). На пятом шаге после внесения изменений в шаблоны и стили пред- 
лагается оценить получившийся результат, воспользовавшись одной из гипер- 
ссылок. При этом веб-страничка, соответствующая использованной гиперссыл- 
ке, открывается в отдельной вкладке браузера. 

Если результат неудовлетворительный, то шестым шагом предписывается 
повторить правку черновика темы, вернувшись к четвёртому и пятому шагам. 

На седьмом шаге предлагается зафиксировать внесённые изменения в 
черновике темы и опубликовать получившийся результат. Для этого на странич- 
ке настройки интерфейса имеются флажки: 

® кп агаН1 Паз рееп 1ее4 апа Гоипа геаау ю ргодисНоп — подтверждение 
готовности черновика темы к эксплуатации; 

® ТНе сигепЕ $Кт зпош@ Бе омеплмиеп \мИВ агай1 — требование заменить те- 
кущую тему темой из черновика. 

Выполнение отмеченных действий происходит по нажатию на кнопку 
РибйзН Огай1 (Опубликовать Черновик1). В результате произведенных измене- 
ний главное меню приобрело вид, показанный на рисунке 9.17. 
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З{ер 8: С!еапир апа Упдо АсНоп$ 


Мей пе 5Кт Адти раде Гог цеапир апд гесоуегу асйоп®. 


Рис. 9.16 
Продолжение настройки веб-интерфейса 


© тре зпо-раде ее ео хо + 


< > С Онезащищено | ЧозйзегиесвО8 1 лата Льчья?ос= Пако =оп 90: 
зипр!е зэта!е-раде меьз$Ке / в.асьо Мепаре — орыя 
= Старт Шкага времени Файлы Ветви Ярлыки Форум Заяыки Документы Пользоватени 


Иа ее Везлев Соки 


Вгапсн Мате + 1251 СВалое | СНеск-пз; + 5121$ + Везошюп + 


Рис. 9.17 
Русифицированное главное меню веб-интерфейса 
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На восьмом шаге приводится гиперссылка ЭКт Адтт, ведущая на стра- 
ничку управления темами, которая упоминалась в самом начале этого раздела. 
Теперь на ней появились дополнительные элементы управления (рис. 9.18). 


= О х 
© $трЕ эпое-раде меБзйе: 5" Х —- 


— СО не защищено | +ю$$й.5егуег:8081 /зеир_5Ки_адти ха о 


Зитр!е зтае-раде ме з$Ке / зклз мепазы — подом 


= Старт Шкала времени Файлы Ветви Пользователи 
ВшиИ-т $Кйп$: 
1.  Оеаий поза! | 
2. ВИ? Платай | 
12. Квак, № Еодо плэтай | 
13. Агдобе Иленай | 


СигтепЕ $Кт т сз5/ЛеадегМос{ег/ае{айЙ$ еп{пез т {пе СОМЕ!С {4аЫе: 
14. Сипет Васкир | 


Ога_й $Ктз з{огед а$ "ага -9]-^' епёпез т {Пе СОМРЕ!С {аЫе: 


15. агай1 Беве 


Рис. 9.18 
Обновлённая веб-страничка управления темами 


В блоке, озаглавленном Ситеп! зКт м сз5/пеадегМосег/е!а!$ ептез т Пе 
СОМЕЮ {аЫе, находится запись о текущей теме. Рядом с ней имеется кнопка 
Васкир, позволяющая сохранить эту тему под своим оригинальным именем. При 
нажатии на эту кнопку запрашивается имя для текущей темы, которое присваи- 
вается ей после нажатия на кнопку Зауе (рис. 9.19). В дальнейшем этот вариант 
темы оформления можно переименовать с помощью кнопки Вепате. 

Внизу веб-странички управления темой имеется блок Ога зКтз зюгед аз 
"аган[1-9]-*" епез т Фе СОМРЕ!@ 1аЫе, в котором перечислены модифицирован- 
ные черновики тем. Рядом с именем черновика имеется кнопка Веве, позволя- 
ющая его удалить, если дальнейшая доработка содержащейся в нём темы 
оформления не требуется. При этом изготовленная на основе удалённого черно- 
вика тема сохранится и может продолжать использоваться. 
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— О х 
© тре этае-раде меБзИе: ба Ж + 


< С А Не защищено | 10$$Й.5егуег:8081/5етир_Ки_аатип х ©@ 


зитр!е $тае-раде меь$Ке / зле сипеги кп 


Мападег — 1090 


Старт Шкала времени Файлы Ветви Пользователи 


Мате Гог 115$ эКт: |Русифицированное меню 


Зауе || Сапсе! | 


ЗКт$ зауе4 аз "5Кт:^' еп1ез т {пе СОМЕ!С {аЫе: 
14. Русифицированное меню (Ситепйу п Цзе) | Вепамте | 
Ога_Я Киз з{огеа а$ "ага -9]-^' еппез т {пе СОМЕ!С {аЫе: 


15. дгайл [ Оеве | 


Рис. 9.19 
Присвоение оригинального имени созданной теме 


9.6. Механизм поиска 


Полезность информационной системы во многом определяется возмож- 
ностью быстрого отыскания требуемых сведений в массиве хранящихся в ней 
данных. С течением времени репозиторий становится ценнейшей коллекцией 
разнообразных сведений о проекте, содержащихся не только в рабочих файлах, 
но и в страницах документации, заявках на доработку и в обсуждениях на фо- 
руме. Только отыскать нужный текст бывает непросто. Перекрёстные гипер- 
ссылки между подсистемами сильно помогают в этом вопросе, но не всегда 
удаётся найти тот конец нити, по которому можно распутать клубок. 

В системе Ео5$1 имеется возможность задействовать механизм полнотек- 
стового поиска, реализованный в базе данных ЗОГ Ще, по информации, накоп- 
ленной в её подсистемах. Чтобы это осуществить, надо воспользоваться пунк- 
том раскрывающегося меню Адтиеаноп Радез, после чего перейти по гипер- 
ссылке Зеагсп (рис. 9.20). 
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о Ре адез юг ТгипК о 1151 оГОРГ$ и5ед \0 ассез$ {115 герозКогу 
© Ипуегзюпеа Ейез о [151 оГАЦНас 

Ргодес{ Титейпе о 1151 оЁ"Титемагр" Свеск-т$ 
о АсНуйу Керой$ . 

Рогит о Репатд Модегайоп Ведие> 
о Кесеги асёуйу о Аатт 109 


Озегз Сгап{ римЙедез {о памачца! изегз. 
Зесищу-Аиади Апауге Пе ситег\ сопйдигайоп фог зесищу ргоетз 
ТПитейпе Титейпе 4р!ау ргЕ{егепсез 
шф [5еагс!] Сопйдиге пе Бий-пт зеагсп епдте 
ОР! Апазез Сопйдиге УРЕ айазез 
ЗКиз Зеес{ апа/ог тодайу {пе меб ищейасе "$Кт$" 
Модегайоп Епае/ОзаЫе геашийпа подегаюг аоогома! о! \\ИК! апа/ог ТПиске{ спапаез ап аКасптеги®. 


Рис. 9.20 
Переход к настройке поисковой системы 


Откроется страница настройки поисковой системы Ео$$1 (рис. 9.21). Пер- 
вые два поля предназначены для настройки поиска внутри документов — фай- 
лов, хранящихся в репозитории. В поле Воситег{ Соб 1$ надо указать маски 
имён файлов, в содержимом которых будет осуществляться поиск. В поле 
Боситег" ВгапсйН требуется указать имя ветви репозитория, файлы которой будут 
участвовать в поиске. Если хотя бы одно из этих полей оставить пустым, то по- 
иск по документам производиться не будет. 

Далее следует группа флажков, с помощью которых можно отметить ин- 
формационные хранилища подсистем Ео$$1|, участвующие в поиске: 


Зеагсп Спеск-т Соттеп{5 — комментарии к точкам сохранения в репо- 


зитории; 


Зеагсн Поситепт{ — документы (файлы, о которых говорилось выше); 
ЗеагсН Т!сКе!5 — заявки на доработку; 

Зеагсп \М/К! — статьи системы документирования; 

Зеагсй Тесп Моф{ез — технические заметки; 

Зеагсн Рогит — обсуждения на форуме. 


Чтобы выполненные настройки вступили в силу, надо нажать кнопку 
Арру Спапдез. С этого момента на страницах веб-интерфейса выбранных под- 


систем 


(рис. 9. 


ПОЯВИТСЯ строка поиска, в которой МОЖНО набирать искомые слова 
22). 
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Зеагси СНеск-т Соттеп!з 
Зеагсн Воситеп{5 
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Рис. 9.21 
Страница настройки поисковой системы 


© тре эпае-раде мебзие: ог Хх + 
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Рис. 9.22 
Строка поиска на странице форума 
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Помимо этого начинает работать специальная страница поиска, доступная 
по адресу И р:/Моз$1.зегуег:8081/зеагсй/ (рис. 9.23). С этой страницы можно запу- 
стить поиск сразу по всем подсистемам или выбрать интересующую область 
поиска из списка. 


© 5тоеЕ элае-раде меБзИе: безо Х + > ы ь 
< (С ОФ Не защищено | 1055.5егуег808 х ©@ 
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Рис. 9.23 
На странице поиска можно искать информацию сразу во всех подсистемах Ео55И 

С произведенными выше настройками поиск выполняется путём после- 
довательного просмотра текстов, хранящихся в выбранных подсистемах, и 
сравнения их фрагментов со словом, введённым в строке поиска. Такой метод 
может занимать длительное время на больших репозиториях. Для увеличения 
эффективности поиска можно создать индекс — словарь, в котором в опреде- 
лённом порядке представлены ссылки на сведения, имеющиеся в информаци- 
онных хранилищах. Использование индекса существенно ускоряет процесс, но 
для хранения словаря используется дополнительное пространство на носителе 
информации. 

При создании индекса можно задействовать алгоритм, позволяющий об- 
наруживать в тексте различные языковые формы искомого слова, что расширяет 
поисковую выдачу. К сожалению, имеющаяся в Ео$3 реализация этого алго- 
ритма не работает для русского языка. 

Чтобы создать поисковый индекс и задействовать его в поиске, надо на 
странице настроек нажать кнопку Стеае А Еи|-Тех! шадех. Если при этом будет 
установлен флажок Цзе Ропег Зеттег, то при создании индекса будет использо- 
ван алгоритм Портера. 


9.7. Объявления 


Иногда возникает необходимость уведомить всех участников проекта о 
каком-нибудь мероприятии. Например, о проведении конференции по вопросу, 
касающемуся разработки проекта, о необходимости подачи сведений для со- 
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ставления графика отпусков, об изменении режима допуска в офисное здание 
или о предстоящем ремонте автомобильной парковки. Вариантов донесения 
информации до сотрудников известно множество: можно организовать собра- 
ние руководителей подразделений и поручить им проинформировать своих под- 
чинённых, можно обойти или обзвонить все кабинеты, можно уведомлять всех 
на входе в здание, а можно вывесить объявление. 

Вариант с объявлением выглядит наиболее привлекательным и наименее 
затратным. Объявление можно перечитать несколько раз, к нему можно вер- 
нуться по прошествии времени для уточнения забытой информации. Хорошо, 
если в офисном помещении есть специально организованная доска объявлений, 
с содержимым которой все привыкли знакомиться. А если нет? 

Система Е05$ позволяет разместить короткое объявление прямо на стра- 
ницах своего веб-интерфейса. Если к этому времени Е0$$1 стал привычным ра- 
бочим инструментом, то такой способ оповещения вряд ли останется незаме- 
ченным. 

Чтобы разместить объявление, надо воспользоваться пунктом раскрыва- 
ющегося меню Адтие!ганоп Радез, после чего перейти по гиперссылке Аад-Цпй 
(рис. 9.24). 
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Рис. 9.24 
Переход к размещению объявления 
Откроется форма размещения объявления (рис. 9.25). На ней имеются два 
больших текстовых поля. Первое поле, озаглавленное Ваппег Ад-Ипй, предназна- 
чено для ввода НТМГ-кода узкого горизонтального баннера, который будет раз- 
мещаться под горизонтальным меню. Второе поле, озаглавленное РаН-Соитп 
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Аа-Ипи, предназначено для ввода НТМГ-кода вертикального блока, который бу- 
дет размещаться сбоку от основного содержимого. На одной странице будет 
отображено только одно объявление — горизонтальное или вертикальное. Вер- 
тикальный вариант используется на страницах с узким содержимым — Е!ез 
(Файлы) и Тадз (Ярлыки). Чтобы активировать внесённые изменения, надо 
нажать кнопку Арру Спапдез. 
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г” Свапдез Бее{е Ад-Цпй 


Рис. 9.25 
Форма размещения объявления 
В нижней части формы (которая не показана на рисунке) имеются реко- 
мендации относительно оформления объявления, в частности рекомендуется 
дописать С5$-стили для некоторых классов в редакторе темы веб-интерфейса. 
Но можно обойтись стилями, встроенными в теги НТМГ. Например, горизон- 
тальный баннер может быть оформлен так: 


<Олу збу1е="илаЕр: 100%; Беларе: 90рх; Еопе-$17е: 0.8ет; ЕехЕ-а119п: сепеег; 
Богаег: 1рх з011а Е11; БаскКакоипа-со1ог: #Есс"> 
<в3>Объявление</В3> 

<р>Имеются билеты на премьеру оперы "Кармен", которая состоится в 
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воскресенье 14 июня.<рг>Обращаться в профком.</р> 
</91\> 
А код вертикального блока может быть таким: 


<а1у зсу1е="Е1оа®: г1арЕ; м1а:180рх; фехЕ-а119п: сепфек; 
Богаег: 1рх з011а Е11; БаскКакоипа-со1ох: #Есс"> 
<в3>Объявление</63> 
<р>Имеются билеты на премьеру оперы "Кармен", которая состоится в 
воскресенье 14 июня.<рг>Обращаться в профком.</р> 
</а1у> 
Тогда объявление на страницах веб-интерфейса Ео5$И будет выглядеть, 
как показано на рисунке 9.26. 


— о х 
© тре эпое-раде меб: Пре х + 


< СО Не защищено | 05$й.5егуег8081/4ос/документация/милм/тдех.та й о 


Зипр!е зэтае-раде мерзКе / простоя одностраничный 


веб-сайт 
Мападег — 1одош 


= Ноте тете Ее; Вгапсвез Узегз 
Объявление 


Имеются билеты на премьеру оперы "Кармен", которая состоится в воскресенье 14 июня. 


в профком. 


Простой одностраничный веб-сайт @ зпрезаераоечеьне не ох ПВ — О х 


Этот проект посвящён разработке шаблона про‹ 
использован для быстрого создания сайта-визи` 


Ключевыми особенностями проекта являются $ ] т р ] а $ ] п |. 1е -ра 0 а уе Ь 5 Це 


» следование веб-стандартам; 
» использование свободных средств разраб / 
» открытая лицензия. 


< С О нНезащищено | +0$$.5егуег8 08 1/4" [= 


ЕИе 11$ Мападег — Год 


= Ноте Ттеше  Чзегз 
Дополнительные сведения: 


АН Тр Ттее-\Мем ТгийК 
® Информационное наполнение 


® Стилевое оформление 
Тре ипюп ога! Шез тот а! сНеск- Объявление 


Обсуждение проекта ведётся на форуме } с 
1$ т {Пе фор-[еуе! атес‘югу 


Имеются билеты на 


5 тадез [ ногкопд. ой премьеру оперы 


"Кармен", которая 
паех 
ими Г пдех сз состоится в воскресенье 


ПВ УСЕМЗЕ Г пдех. вит! ЗА июня: 
П чето.рд Обращаться в профком. 
Рис. 9.26 


Горизонтальный баннер (слева вверху) и вертикальный блок (справа внизу) с объявлением 
На форме размещения объявления имеются флажки, позволяющие отклю- 
чить показ объявлений: 
® Отй ад$ ю адатитгаюг — для администраторов системы Е 0531; 
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® Оти аа ю юддед-т изегз — для всех пользователей, которые авторизо- 
вались в Е0$$1; 

® Тетрогайу ЧзаЫе а! а4$ — для всех посетителей веб-интерфейса. 

Последний флажок удобно использовать, если объявление надо подгото- 
вить заранее, а демонстрировать пользователям — позже. 


9.8. Обозреватель файлов 


Рабочие файлы проекта, соответствующие любому историческому этапу 
разработки, могут быть выгружены из репозитория в рабочий каталог с помо- 
щью команды 10$$Й сНескош. Для участников проекта такой способ не составит 
труда, но стороннему наблюдателю перед этим придётся разобраться с системой 
Ео5$ и настроить индивидуальное рабочее место. Если у кого-то возникла 
необходимость в однократном получении какого-нибудь файла из репозитория, 
описанный способ требует слишком больших усилий. 

К счастью, сервер Роз предоставляет возможность доступа к файлам, 
хранящимся в репозитории, через веб-интерфейс. Для доступа к файловому ар- 
хиву служит пункт главного меню Е!ез или пункт раскрывающегося меню ЕИе 
Вгомизег (рис. 9.27). 


© тре эта-раде меБзйе: ЕЕ Ж + 


— С ОФ Не защищено | {05$й.5егуег8081/ди?с=#Нр * ре 


этр/[е этае-раде меб$Ке / нецх в 


= Ноте Тите!те ЕИез Вгапсбе$ 


тем, Тгипк Свеск-т 


о Наемем 
о ЕИе адез ог Тгипк 
© Ипуегзюопед Ейез 


® Ргоес!Титейпе 
о АсНуйу Керой$ 
о Ее пате спапдез 
о Рок$ 
о Еиз{ 10 спеск-т$ 


Рис. 9.27 
Переход на страницу файлового архива 


9.8.1. Просмотр списков файлов 


На открывшейся после выбора пункта меню веб-странице будет отобра- 
жён список файлов и каталогов, соответствующих самой поздней точке сохра- 
нения, созданной в репозитории. Если эта точка сохранения находится не на ос- 
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новной ветви разработки, то не стоит удивляться тому, что в этом списке отсут- 
ствуют все файлы рабочего каталога проекта. В этом случае можно воспользо- 
ваться пунктом дополнительного меню А!, чтобы система Ео$5Й объединила в 
одном списке самые последние версии файлов из всех точек сохранения 
(рис. 9.28). 

© $тьЕ эта-раде мебзйе: ЕЕ + 5 ы х 


— С О не защищено | Фю$$1.5егуег:8081/ат ж о 


тре зэтае-раде ме $Ке / нес с 


= Ноте Ттеште ЕИе$ Вгапсвез 


А! | Тр Ттее-\Мем — Тгипк 


Тре ипюп ога! Шез тот а| спеск-из т {Пе {ор-еуе! атесфогу 


5 тадез С дето.{рд @ паех.с$$ 
В УСЕМЗЕ Ё нагкопа.9# С пдех.т 
Рис. 9.28 


Для отображения последних версий всех имеющихся в репозитории файлов 
можно воспользоваться пунктом дополнительного меню А! 

Неудобство этого режима состоит в том, что в каталогах отображаются 
даже перемещённые или удалённые из них файлы. Например, в корне проекта 
присутствуют файлы 4ето.]рд и Па’ОКдпа.0, которые при реструктуризации бы- 
ли перемещены в подкаталог !тадез. Конечно, последние варианты этих файлов 
имеются в подкаталоге !тадез, но такой вариант отображения может затруднить 
поиск нужного файла по его имени. 

Зато в этом режиме в дополнительном меню появляется пункт Тгипк, с 
помощью которого можно посмотреть файлы, соответствующие последней 
точке сохранения основной ветви разработки. Обычно это именно то, что 
требуется. 

Если основная ветвь была переименована, то этот пункт меню не сра- 
ботает (что ещё раз говорит в пользу сохранения имени основной ветви). То- 
гда остаётся только явно указать наименование ветви в адресной строке веб- 
браузера: ИЁр:/Моз$1.зегуег:8081/аи?с<!=основная, где основная — это название 
интересующей ветви. Вместо названия ветви можно указать идентификатор 
любой точки сохранения, и тогда будет открыт список относящихся к ней 
файлов. 

Вернуться в режим отображения файлов, соответствующих последней 
точке сохранения, можно с помощью пункта дополнительного меню Тр. 
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Файловый менеджер системы Еоз5Й позволяет переключать режимы 
отображения. Так, с помощью пункта меню Тгее-\Мем можно включить режим 
отображения файловой иерархии (рис. 9.29) с возможностью сортировки по 
имени файлов или по времени их модификации, используя выбор из списка с 
вариантами $ой Ву ЕЙепате и $оп Ву Тите. 


@ этое этае-раде ме 


= С оО не защищено | 10$$й.5егуег:8081Агее{уре=гее * © 


тре зэтае-раде меБ$ЁКе / нетее г 


= Ноте ТПте!шпе Ее Вгапсвез$ 
Нан\Лем Пр Тик [оп Ву 
| Зоп Ву Пте 


Зой Ву Р№епате 


РоЗегз Оп 


ЕНез тот а! 43 снеск-тз зомеЯ Бу Шепате 


(5 тре этае-раде ммебзйе 2020-05-21 08:58:32 
П чето.рд 66.7 дауз 

Г) покопа. ди 66.7 дауз 
-С7 тадез 65.0 дауз 
Г? пдех.с$5 11.0 тпщез 

Г] пдех вт! 640 дауз 

ПВ НСЕМЗЕ 68.5 дауз 

Рис. 9.29 


Иерархический (древовидный) режим отображения файлов, который включается 
с помощью пункта меню Тее Мем,. Можно упорядочивать файлы по имени ($оп Ву 
ЕЙепате) или по времени модификации (Зоп Ву Тте). Скрыть простые файлы и оставить 
только каталоги позволяет флажок Ео!дег Оту 


Для упрощения навигации в больших проектах можно установить флажок 
Роаегз$ Опу, в результате чего в списке останутся только каталоги. После пере- 
хода в нужный подкаталог этот флажок надо установить, чтобы отобразился 
список содержащихся в нём файлов. 

В режиме Ре Адез файлы отображаются в порядке убывания давности их 
модификации или попадания в репозиторий. При этом рядом с каждым файлом 
отображается примечание к точке сохранения, в которой он был обнаружен 
(рис. 9.30). 
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— О х 
@ тре эта-раде меБзИе: Ее + 


— С —Фне защищено | ю$$Й.5егуег:8081/Яеаде?пате=Яе8бас57022466е х @ 


тре этае-раде мерзКе / нелоез по 


= Ноте ТПтете 25 Вгапспез 


Тгее-\М ем 


РИе$ шт [Пе8бас570] огаеге4 Бу аде 
ЕШе адез аге ехргеззе4 ге!айуе {о {пе [Пе8бас570] спеск-т те о! 2020-05-21 08:58:32. 


Аде РИез Снеск-т 


11.0 тпшез  шдех.с$$ принято масштабирование иллюстраций по заявке 
ЕАУабе2еее8} (спеск-т: 5е3ЗЗОББес, изег: Мападег, 
БгапсН: {гипК) 


64.0 дауз пдех. пит! принято содержимое веб-страницы (свеск- 
п: 951е92е400, изег: Мападег, Бгапсй: {гипК) 
65.0 дауз ипадез/й25капа.9й добавлено фоновое изображение для заголовков 


информационных блоков (спеск-п: 2672с9с02Ь, 
изег: Оезапег, Бгапсп: {гипК) 


66.7 дауз итадез/дето.|рд добавлены графические элементы для заголовка и 
ипадез/пакапа.дй информационных блоков (спеск-п: 178еа62035, 
изег: Оезапег, Бгапсй: {гипК) 


68.5 дауз ИСЕМЗЕ добавлен файл лицензии МП (спеск-т: 307777себс, 
изег: Мападег, Бгапсп: {гипК) 


Рис. 9.30 


Отображение файлов в виде таблицы в порядке убывания времени модификации, 
устанавливаемое пунктом меню Ее Адез$ 


9.8.2. Операции над файлами 


Во всех рассмотренных режимах просмотра имена файлов являются ги- 
перссылками, с помощью которых можно перейти в режим их просмотра. Си- 
стема Ео5$1 умеет определять типы файлов по их расширению и по умолчанию 
отображает их наиболее естественным образом. Например, файл таех.Нт! 
отображается как веб-страница, получившаяся в соответствии с содержащимся 
в файле НТМГ-кодом. Поскольку при этом не используются подключаемые 
стили, то результат выглядит не совсем презентабельно. В рассматриваемом 
примере лучше воспользоваться пунктом дополнительного меню Тех чтобы 
перейти в режим просмотра исходного текста (рис. 9.31). В этом режиме можно 
установить флажок Ипе Митбегз, чтобы отображались номера строк. Вернуться 
в предыдущий режим можно с помощью пункта меню Нит!. Пункт меню Нех 
даёт возможность включить режим просмотра шестнадцатеричных кодов, кото- 
рый может оказаться полезным для двоичных файлов. 
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< со 


Ш 


Спеск-тз У5п9 


АПНас{ 


» Ее пдех.в 


Соарапу 
Зесноп 1 
Зесноп 2 
Зесноп 3 
Зесной 4 


Гогет 
трэш до1ог 
зи атлет 


Сошрапу 


© тре зпде-раде меБ5йе; Ап’ Хх + 


эитр!е зэта!е-раде мер $Ке / длинах сомепилли 


Ноте Титейпе ЕИез Вгапспез 


@ 7551594959844194967аа5974546Я20с960аа1е289387се71с985551а7521: 


принято содержимое веб-страницы (изег: Мападег, ге: 3919) [аппо!={е] [Мате] [сПпеск- 
1$ из1п9] [ппоге...] 


25 | х 


Не защищено | #0$$Й.5егуег8081/а{асу/7561549598941949 х © 


Оо\мпюа9 Тех! 


{11| — рац оРсВеск-т [961е92е400] ай 2020-03-18 09:03:17 оп БгапсВ {гипк — 


ЫЫ мБ 


Спеск-тз /3т9 ОЭо\упюа9 Нех Нат! “! Ипе Митьегз 
1 <!аосфуре В&т1> 
2 <НЕтЕ 1апё="ги"> 
3 <Веаа> 
4 <{1{1е>51пр1е $1п21е-раре меб$1{е</{1{1е> 
5 <тефа спаг5е{="и{+-8"> 
6 <14пК Вге#="1п4ех.с$5" ге1="5{у1езНее{" туре="+ех{/с55"> 
7 </пеаа> 
8 <Боду> 
9 <Веадег> 
19 <пау> 
11 <и1> 
12 <11>‹а Вге+="#сотрапу" >Сотрапу</а></11> 
13 <11>‹а Пге{="#5ес{1">5ес{1оп 1</а></11> 
14 <11><‹а вге+="#5ес{2">5ес1оп 2</а></11> 
15 <11><‹а Вге+="#ес{3">5ес1оп 3</а></11> 
16 <11><‹а Вге+="#ес{4">5ес{1оп 4</а></11> 
17 </и1> 
18 </пам> = 


Рис. 9.31 


В режим просмотра исходного текста файла можно переключиться с помощью пункта 
меню Техф а для отображения номеров строк — установить флажок пе Митбегз 


С помощью пункта меню Спеск-тз Узтд можно переключиться в режим 
отображения шкалы времени, на которой будут показаны только те точки сохра- 
нения, в которых присутствует выбранный файл. 

Наконец, пункт меню Оо\мпоаЧ даёт возможность выгрузить выбранный 
файл из репозитория. Однако работа этого пункта меню имеет одну особен- 
ность. Поскольку при его выборе приводится в действие гиперссылка на вы- 
бранный файл, то веб-браузер, настроенный на отображение файлов определён- 
ных типов, вместо предложения сохранить его на диск может просто показать 
содержимое файла в своём окне. 

Если требуется именно сохранить файл в файловую систему компьютера, 
то надо на пункте меню БомпюоаЯ с помощью правой кнопки мыши вызвать 
контекстное меню веб-браузера и выбрать в нём пункт Сохранить ссылку как... 


(рис. 9.32). 
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— Ноте ТЛтеште Е!ез$ Вгапспез 


Спеск-тз 59 Бо\митоа@ Тех! 


Открыть ссылку в новой вкладке 


АгГас! г 7561599598 аа — Открыть ссылку в новом окне }5551а752Н: 
Открыть ссылку Б окне Б режиме инкогнито 
» Ее шдех Мп! — рай о? гипк — 
принято содержимое ве — Сохранить ссылку как... Я [спеск- 
$ изд] [поге...] ю 
Копировать адрес ссылки 
Просмотреть код СЕ + ЗВ + | 
® Сошрапу 
® бесноп 1 
Рис. 9.32 


Для сохранения файла надо вызвать контекстное меню на пункте Воитоаа 
и выбрать в нём Сохранить ссылку как... 

В целом можно сказать, что режим просмотра файлов предлагает альтер- 
нативный способ навигации по истории проекта, в котором ориентиром явля- 
ются не точки сохранения, а файлы рабочего каталога. В некоторых ситуациях 
этот способ удобнее, чем использование шкалы времени. 


9.9. Бесконтрольные файлы 


Все рассмотренные подсистемы Е05$Й используют для хранения своих 
данных тот же механизм, который лежит в основе контроля версий. Это означа- 
ет, что хранится полная история изменений каждого объекта, будь то заявка на 
доработку, страница документации или сообщение на форуме. И в большинстве 
случаев применение этого механизма оправдано как с точки зрения сбора мак- 
симально полной информации о проекте, так и с точки зрения эффективности 
хранения данных (дописываются только изменения, которые были внесены в 
тот или иной текст, а не полное его содержимое). 

Однако бывают ситуации, когда историю изменений хранить нежелатель- 
но. Например, сервер Еозз удобно использовать для распространения архивов 
с дистрибутивами разрабатываемого продукта. Однако хранение всех вариантов 
двоичных файлов было бы в данном случае совершенно лишним. Всё необхо- 
димое для создания любой версии такого дистрибутива и так имеется в репози- 
тории. А если в базе данных Розз1 будут накапливаться все двоичные файлы, 
соответствующие каждому выпуску продукта, то её размер может недопустимо 
увеличиться. Другая ситуация — распространение через сервер Еоз$Й инстру- 
ментов, которые используются в работе над проектом: текстовый редактор, 
компилятор, отладчик и т. п. 

Система Ео$зП даёт возможность записывать в свою базу данных файлы, 
минуя механизм контроля версий только для того, чтобы распространять их че- 
рез свой сервер. Такие файлы называются ипуегз1опе4 (неверсионированными), 
но для благозвучности по-русски будем называть их бесконтрольными, подра- 
зумевая, что на них не распространяется контроль версий. 
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Предположим, что менеджер решил использовать бесконтрольные файлы 
для размещения на сервере дистрибутивов системы Е0$$1. Тогда новый член 
команды при подготовке своего рабочего места сможет загрузить этот инстру- 
мент прямо с веб-сайта проекта. Для этого менеджер создал отдельный каталог 
10015 (за пределами рабочего каталога проекта) и записал в него файлы Ю$$1- 
\м32-2.10.21р, Ю$$й-м64-2.10.2р и таех.т!. Первые два файла — это те самые 
дистрибутивы, а третий файл содержит НТМГ-код страницы загрузки. 


Листинг файла таех.йт! 
<!аосбуре ВЕп1> 


<рем1 1апад="ги"> 

<реаа> 

<тефа свагзее="аеЕ-8"> 

<Е1Е1е>Страница загрузки инструментов</1Е1е> 
</Веаа> 

<Боду> 

<в1>Инструменты для работы над проектом</61> 
<пу> 

<в2>Система контроля версий</62> 

<и1> 


<11><а ВхеЕ="ЁЕоз$11-м32-2.10.21р">Еоз$11 (И1паомз 32)</а></11> 
<11><а пхеЕ="Еоз$11-м64-2.10.21р">Еоз$11 (И1паомз 64)</а></11> 
</и1> 

<Вх> 

<а ргеЕ="../">Назад к репозиторию. </а> 

</Боау> 

</вЕт1> 


Затем менеджер сделал каталог 1005 текущим и выполнил команду для 
добавления бесконтрольных файлов в базу данных репозитория: 


Еоз$11 цу ааа *.* -В ..\ззриерз1ее-1оса1.Ео$$11 


В данной команде *.* — это маска добавляемых файлов, а с помощью па- 
раметра -^ указывается путь к файлу репозитория Е0$$1. Хранилище бескон- 
трольных файлов в Ео$$1 «плоское», в нём нельзя создать иерархию каталогов. 
Просмотреть имеющиеся в базе данных файлы можно с помощью команды: 


Е0$5811 чу 1156 -В ..\ззрмерз1фе-1оса1.Ео$$11 
В рассматриваемом примере она вывела такую таблицу: 


5Е4034037абе 2020-05-23 15:51:07 2258184 2258184 Ео5511-и32-2.10.71р 
9196с014ЪЕ9с 2020-05-23 15:51:07 2667722 2667722 Е0о$5511-и64-2.10.71р 
4е9с0Ъ90е5а9 2020-05-23 15:51:07 520 336 1паех. ВЕ 

На текущий момент бесконтрольные файлы записаны в локальный файл 
репозитория на рабочем месте менеджера, а для того, чтобы организовать их 
распространение через сервер, их надо на сервер отправить. Но бесконтрольные 
файлы не участвуют в синхронизации, которая происходит между локальными 
и сетевыми репозиториями при обычной эксплуатации системы контроля вер- 
сий. Это разумно, потому что ценности такие файлы не представляют, и не име- 
ет смысла их реплицировать на все репозитории, тем более что они могут зани- 
мать значительный объём. 
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Чтобы загруженные в локальный репозиторий файлы отправились на сер- 
вер, надо ввести команду: 


Ео0$5811 ау зупс -В ..\ззрмерз1фе-1оса1.Ео$$11 


Однако выполнить эту операцию сможет не ВСЯКИЙ пользователь, а только 
имеющий разрешение для записи бесконтрольных файлов на сервер \М/\е 
ИУпуегзюопеа (код у). У менеджера такого разрешения не было, и его попытка за- 
вершилась неудачей: 

Магтп1149: иу-ри11-оп1у 

Опар1е Фо разр ипуегз1опея сопеепЕ Бесачзе уой 1аск 
зиЕЁЕ1с1епе реги1$51оп оп Ве зегуег 

Воппа-Ег1рз: 1 АгЕ1Еас®5 зепе: 0 гесе1уеа: 0 

Чопе, зепе: 352 гесе1уеа: 324 1р: 192.168.56.101 


Предоставить необходимое разрешение может только владелец репозито- 
рия (прав администратора для этого недостаточно). Поэтому придётся автори- 
зоваться в системе под именем и установить требуемую отметку в карточке 
пользователя Мападег (рис. 9.33). 


= О х 


{ эитр!е эпо!е-раде меб зе; Еф" Х + 
< СО Не защищено | 10$51,5егуег:8081/5етир_иеди?а=10 х ©@ 


эитр!е зэтае-раде ме з$Ке / ели оз мападег — заириьы 


= Ноте Титейле Еез Вгапспез Озегз 
Ассе5$ 109 Сапсе! 


Озег 10: 10 
Годт [Мападег | 


Сопасе 1ПЮ: |тег@Ро$541.зегуег 


Сара ез Ади О Ацасптел$ О Мм Тске!5 д] О Веаад Рогит 
С Веадег О Сюпем О Аррепад То Пскецд О Ме Рогит 
О Бемеюрег О Веаа Умким О Миие Псказив __ О МимеТгичеа Рогит 
Ц Мем-Р ру —- ыы я (1 Модегае Рогит 
ОР " О Мем \/ю О Модегае Тскев — [] бирегизе Рогит 
— г а55\о в] — [С Аррепа МКИ} (С) Тске Веройв} О Етай Аец® 
Е а О ме МА в Ц Риуае О $епа Аппоипсетегиз 
С Спеск-Очим — С моаегае Мю Мне УпуегзюпеЯ — Г) ЕпаЫе ОеБид 
О Нурей"кзд, С Веаа Тскецц Г Бомпюаа Ир] 


Зае<еч4 Сар: ау (Кеу) 


Разз\мога: | чении | 
д" Спапдез | | аые Озег | | Сапсе! | 


Рис. 9.33 
Предоставление разрешения для отправки бесконтрольных файлов на сервер 


При повторном выполнении команды информационный обмен прошёл без 
ошибок: 


Воппа-6г1рз: 4 АгЕ1Еас®5 зепе: 3 гесе1уеа: 0 
Чопе, зепе: 4924731 гесе1уеа: 1255 1р: 192.168.56.101 
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Чтобы посмотреть, какие бесконтрольные файлы имеются на сервере, 
можно воспользоваться в веб-интерфейсе пунктом раскрывающегося меню 
Аатиузгайоп Радез и перейти в открывшемся окне по гиперссылке Упуегзюпед 
РИез (рис. 9.34). 


{ ЗитрЕ эпд!е-раде мебзйе: Пре Х + 


< С (О Не защищено | 10551.5ег/ег8081/зйир о а 


Зитре зэтае-раде меь$Ке / простоя одностраничный веб-сайт 


Мападег 
= Ноте Титейпе Ре5 Вгапспез Озегз 
» Ноте Раде ® 1090щ 
» Ее Вгомзег о Спапде Раззмога 
о Ттее-ме\, ТгипКк Свеск-п » Керозйогу Заз 
о Намем о Со!зюопз оп ВазВ ргейхез 
о ЕИе адез юг ТгипК о 151 оГОРЕ$ изед 10 ассез$ 15 геро$Йогу 
о Ипуегэюпед Ейез о [151 оГАПИас!5 
® Ргдес!Титейте о 1151 ог"ПИтемагр" Спеск-т$ 
о Асймйу Веройз . 
о Ее пате спапдез о Репата Модеганоп Ведие!5 
о Рож$ о Адтт 109 
о Еиз{ 10 спеск-тпз о Заз о Пе ммеБ-раде саспе 


АПНас{! Весер{5 109 Агесога оЁгесемед а\й#ас{$ апд Пей зоиугсез 
Озег1о9 Агесога о! 1одт аНетр!5 
Адпипэгануе год  \Ме\м Че адт_1ю04 епез 
Еггог 09 \Ме\м Ве Роз$1 зегуег егтог |109 
Опуегзюпед Е!ез]| ЗПом/ а! ипуегзюпеа Шез Ве!4 
Заз Керозйогу Заз Керой5 
Зцетар ИпкК$ {о пизсе!апеоиц$ радез 


Рис. 9.34 
Переход к просмотру бесконтрольных файлов 


В рассматриваемом примере список бесконтрольных файлов выглядит, 
как показано на рисунке 9.35. 


{тре япое-раде мебзИе: Ито хо + в в ^ 
< -> С О незащищено | 4055й.5егуег8081/и\ 5 Буаде=1 х © 
Зитр/!е зта!е-раде меьзКе / чегзопеч пез Мапа 


= Ноте тете Нез Вгапспез зегз 


[мате г [две [зе ® [бег | [9 
10551-32-2.10 р 2.3МВ 514034037абе32034а97154843125066127с"76249450е2939а1844ее651а8ь [66 _ | 


105$1-м/64-2.10. р 2.7МВ 9196с014619с0829156а97849603411356755518464а4с736е2а2аде1695641 
520 БУез 4е9с0Ь90е549са78166а145е364475е555ае4449е015655с79261998844есе[68 __| 
май омег Зез | [49мв [Г 


Рис. 9.35 
Таблица со списком имеющихся на сервере бесконтрольных файлов 
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Если в дальнейшем потребуется обновить какой-нибудь бесконтрольный 
файл, надо для нового файла повторить процедуру добавления его в локальный 
репозиторий с помощью команды {0$$й ад А и отправки его на сервер с помощью 
команды Ю$$1 иу зупс. При этом, как уже отмечалось, старый вариант файла в 
хранилище будет перезаписан и утрачен безвозвратно. 

Файлы можно не только загружать в хранилище, но и удалять из него. 
Например, чтобы удалить из хранилища бесконтрольный файл 10$$й-\№32-2.10.21р, 
надо выполнить команду: 


Ео3311 цу гм Е0$$11-м32-2.10.21р -В ..\ззриерз1ее-1оса1.ЁЕоз$11 


Как и при добавлении, удаление произойдёт из файла локального репози- 
тория ..\ззрмебзНе-са!М$$1. Для удаления этого файла из хранилища сервера 
надо выполнить синхронизацию хранилищ: 

Ео$811 чу зупс -В ..\ззрмерз1фе-1оса1.Ео$$11 

Базовый адрес хранилища бесконтрольных файлов на сервере имеет вид: 
Бр:/№$$1.зегуег:8081/и\/. Например, если набрать в адресной строке браузера: 
ВИр:/Моз$И.зегуег:8081/и\Лпаех.пт1, то будет запрошен загруженный в это храни- 
лище файл таех.Пт|, представляющий собой НТМГ-код веб-страницы загрузки 
инструментов (рис. 9.36). Таким образом можно создать в главном меню веб- 
интерфейса репозитория пункт Оомпюа4, аналогичный таковому на официаль- 
ном сайте проекта Ео$$1. 


я - @х 
$ ‚ Страница загрузки инструмент‹ Х + 


С О Не защищено | +0$$1.5егуег:8081/им/паех.В т! ж о 


Инструменты для работы над проектом 


Система контроля версий 


® Еозз! (МЛа4олиз 32) 
® Еозз! (МЛа4олуз 64) 


Назад к репозиторию. 


Рис. 9.36 
Страница загрузки инструментов 
Как уже было отмечено, бесконтрольные файлы не участвуют в обычном 
клонировании и синхронизации репозиториев (и это разумно). Однако участни- 
ки проекта всё же имеют возможность их получить в свои локальные репозито- 
рии, если укажут параметр -и в командах Юз$1 сопе или Ю5$1 зупс, либо выпол- 
нят специальную команду: 


Ео$511 пу зупс -В ззрмерз16е-1оса1.Ео$$11 
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При желании в любой момент можно очистить хранилище бесконтроль- 
ных файлов в конкретном файле репозитория Ео$$И (например, в ззрмерзйе- 
10са!.10551) с помощью команды: 


Ео$$11 за1 "РВОР ТАВЬЕ ипуегз$1опеа; УАСООМ;" -В ззриерз1е- 
1оса1.ЁЕ0$511 


Однако такое удаление, в отличие от команды 10$$1 иу пт, не формирует 
инструкции для системы Еоз$Й, требующей распространить это действие на 
синхронизируемые репозитории. По этой причине, если теперь выполнить ко- 
манду синхронизации хранилищ 10351 им зупс, вместо очистки хранилища сете- 
вого репозитория будет выполнено получение бесконтрольных файлов из сете- 
вого репозитория в локальный. 
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ЗАКЛЮЧЕНИЕ 


3.1. Организация резервного копирования 


В начале этой книги описывалась вымышленная ситуация, в которой её 
персонаж одномоментно безвозвратно утратил все свои наработки, хотя следо- 
вал разумной рекомендации создавать и поддерживать в актуальном состоянии 
резервные копии важных данных. Видимо, книга должна была подсказать ре- 
шение этой проблемы. Однако, если хорошо подумать, проблема по-прежнему 
актуальна. 

Система контроля версий действительно хранит в репозитории историю 
изменений всех файлов проекта. В сетевом варианте использования эта инфор- 
мация распределяется между всеми участниками проекта. Казалось бы, всё 
предусмотрено. Однако корень проблемы заключается в том, что репозитории 
хранятся в файлах, те, в свою очередь, — на материальных носителях информа- 
ции, а физические объекты подвержены поломкам. 

Если в результате редкого природного явления или действия вредоносной 
программы в файле репозитория поменяются несколько байтов, это, возможно, 
никак не отразится на осуществляемой с ним работе. В репозиторий по- 
прежнему будут записываться новые снимки рабочих каталогов, по-прежнему 
будут идти обсуждения на форуме, файл репозитория по-прежнему будет регу- 
лярно копироваться на резервный носитель информации... 

Но только это уже будет повреждённый файл, содержащий в себе мину 
замедленного действия. Возможно, она никогда не проявится. Может быть, по- 
вреждённой окажется картинка, которую легко восстановить. Но если повре- 
ждения затронут структуру базы данных ЗОГе, последствия трудно предска- 
зать. 

Поэтому даже при использовании системы контроля версий остаётся риск 
утраты ценной информации. Но система Ро5$ позволяет свести этот риск к ми- 
нимуму, если перед выполнением резервного копирования файла базы данных 
репозитория проверять его целостность. Хранение данных в репозитории орга- 
низовано по принципу, напоминающему популярную в мире криптовалют тех- 
нологию блокчейн. Поступающий в репозиторий элемент, будь то моменталь- 
ный снимок рабочего каталога, сообщение на форуме или заявка на доработку, 
снабжается заголовком, который называется манифестом (тат 50. Помимо 
сведений о добавленном элементе (дата и время, описание, имя пользователя) в 
этот заголовок записываются контрольные суммы как добавленного элемента, 
так и его предков. 

В результате получается цепочка, в которой контрольная сумма следую- 
щего звена зависит от содержимого предыдущего. Именно поэтому однажды 
записанная в репозиторий информация не может быть из него удалена — для 
фактического удаления элемента потребовалось бы пересчитывать контрольные 
суммы всех элементов, добавленных позже, т. е. перестраивать репозиторий. Но 
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зато такой способ хранения данных позволяет проверить их целостность и об- 
наружить несанкционированные изменения. 

Пересчитывать контрольные суммы всех элементов и сверять их с запи- 
санными в заголовках при выполнении каждой операции с репозиторием было 
бы слишком накладно с вычислительной точки зрения. Поэтому для проверки 
целостности файла репозитория имеется специальная команда №055 {е${- 
пщеотйу. В качестве параметра ей надо указать имя проверяемого №0$5-файла. 
Например, для проверки базы данных репозитория проекта, рассматриваемого в 
этой книге, на сервере надо ввести команду: 


Ео$$11 сезе-1пседг1еу ззрмерз16е.Ео$$11 
Будет пересчитана и проверена вся цепочка контрольных сумм, и в случае 
отсутствия ошибок программа сообщит: 


120 поп-рвапеом Ь1оБ5$ (ое оЕЁ 120 Еофа1) спВесКкеЯ: 0 егкогв 
120 блоков данных (из 120 всего) проверены: 0 ошибок 


1ом-1еуе1 Чафбаразе 1п6ечх1Еу-сВесКк: ок 


Низкоуровневая проверка целостности базы данных: ок 


Если же такое сообщение не будет получено или будет получено другое 
сообщение, то это говорит о наличии повреждений в проверяемом файле. 
Например, подобный вывод команды должен насторожить: 


мгопа Базб оп агЕ1Еасе 117 


$К1р ррапеом 164 
Оее2 7070866ср2Е9120ЕЕа89с96еее26Е09351337997е642540988с1а030аеб9 


165/167 


$К1р ррапбом 165 
80еа85565са310Е524с492014ес7Е5626сЕ431е4ае324сбъеа574с0За3 сБаЪ9Ь 


166/167 


5К1р ррапбом 166 
92а4Е34е513с7245062925Е45е768а077354аЕ641е0668851с79279460а9 95ае 


167/167 


$К1р ррапбом 167 
9059258сЕ9427ЕЗесааа6{Е399987е24е6184Е30906а616Е213Е2а9Е21а70357е4 


163 поп-рвапеом Ь1ор5 (ой оЕ 167 Еофа1) срВескеЯ: 1 егкогв 
1ом-1еуе1 Чабафазе 1пкеак1еу-сВесКк: ок 


В первой строке говорится о том, что контрольная сумма элемента репо- 
зитория номер 117 не прошла проверку. Но сообщение в последней строке о 
том, что целостность структуры базы данных не нарушена, по крайней мере 
оставляет надежду на восстановление информации. Внешне такой репозиторий 
может продолжать нормально функционировать — принимать новые момен- 
тальные снимки, поддерживать обсуждения на форуме. Однако из-за принципа 
организации хранения информации в репозитории (в виде отличий от преды- 
дущего состояния) высока вероятность того, что ошибка распространится на 
последующие моментальные снимки. 

Другой пример сообщения об ошибке при проверке файла №$$1- 
репозитория: 


259 


117/122 

ЗОТТТЕ _СОВВУРТ (11): АЯабафазе соггар®1оп аб 11пе 68308 оЕ 
[с20а353364] 
ЗО: СЕБЬЕСТ сопбепе ЕВОМ Б1оЬ ИНЕВЕ тг1Аа=:г1а АМО з1хе>=0 
ЗОЬ: ЗЕЪЕСТ г1а, яи1А, з17те ЕВОМ Р1оь ОБРЕВ ВУ гла 
ЗОТТТЕ СОВВОРТ (11): зЕабемепЕ а богЕз аё 6: [ЗЕЪЕСТ сопЕепе ЕВОМ 
Ь1оь МНЕВЕ г14=:г1а АМОР $17е>=0] аафаразе 91$К 1таде 1$ па1Еогимеа 
ЗО: СЕЬЕСТ сопбепе ЕВОМ Б1оЬ ИНЕВЕ т1Аа=:к1а АМО з1хе>=0 

ЗОЬ: ЗЕЪЕСТ г1а, яи1А, з17те ЕВОМ Р1оь ОВБРЕВ ВУ гла 

Рабаразе еггог: ЗОТЪ еггког (11,11: Чабаразе @913зКкК 1маде 15$ ща1Еогпеа) 
\мр11е кгиопп1па [ЗЕЪЕСТ сопеепЕ ЕВОМ Р1ор МНЕВЕ г1а=:г1а АМО 51хе>=0] 


Здесь уже говорится о повреждении структуры базы данных. Скорее все- 
го, проблемы будут заметны и при обычной работе с репозиторием. Аналогич- 
ные ошибки будут возникать при синхронизации репозиториев или выполнении 
других операций. 

Чтобы своевременно обнаружить повреждение файла репозитория, надо 
регулярно выполнять проверку его целостности с помощью приведенной выше 
команды. А во избежание описанной в начале книги неприятной ситуации та- 
кую проверку в обязательном порядке надо выполнять перед резервным копи- 
рованием файла репозитория. 

Процедура резервного копирования, как правило, автоматизирована. По- 
этому оценку результата проверки целостности файла репозитория удобнее 
производить не по текстовому сообщению, которое выводится на стандартное 
устройство вывода, а по коду завершения. В соответствии с принятыми согла- 
шениями программа №0351 возвращает операционной системе нулевое значение 
в случае успешного завершения и значение, отличное от нуля, в случае обнару- 
жения ошибки. Тогда для выполнения резервного копирования в среде операци- 
онной системы УЛпдо\$ можно использовать командный файл баскиргр.ба{ сле- 
дующего содержания. 


Листинг командного файла Баскиртр.Ба! 


@ЕСНО ОЕЕ 

ЕСНО Резервное копирование файла репозитория Го$511. 
ЕСНО %1 

Ео$$11 Еезе-1п$едг1еу $%1 

ТЕ ЕВВОВЬЕУЕТ 1 СОТО ЕВКОВТ 

ЕСНО Проверка целостности завершена успешно. 

СОРУ %1 БР: \ВАСКОР\ 
ТЕ ЕВВОВЬЕУЕТ 1 СОТО ЕВВОВ2 
ЕСНО Завершено успешно. 
СОТО ЕОЕ 

: ЕВВОВ1 
ЕСНО *** ОШИБКА ПРОВЕРКИ ЦЕЛОСТНОСТИ РЕПОЗИТОРИЯ *** 


ЕСНО *** ОШИБКА КОПИРОВАНИЯ ФАЙЛА *** 
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Тогда для выполнения копирования файла репозитория САРВЕРОЗ\ 
ээрмебзКе.10$$1 надо выполнить команду: 


Баскиргр.рБафе С: \ВЕРОЗ\ ззриерз1Ее.Еоз$11 


При выполнении команды в сценарий вместо переменной %1 будет пере- 
дано указанное в командной строке имя файла репозитория. Команды ЕСНО вы- 
водят на экран информационные сообщения. Проверка целостности файла ре- 
позитория производится командой ю$$1{етедщу %1. 

Непосредственно следующая за ней команда 1-Е ЕАРОНЕЕУЕЕ 1 СОТО 
ЕАВОН1 вызывает переход к метке ЕРВОВ1, если код завершения, возвращён- 
ный предыдущей командой, больше или равен единице, что, как было сказано, 
свидетельствует об ошибке проверки. Если же код завершения не больше нуля, 
то выполнение команд продолжается в порядке их следования в тексте сцена- 
рия. Таким образом, предыдущая резервная копия будет перезаписана новой 
только в том случае, если копируемый файл репозитория пройдёт проверку це- 
лостности. 

Вторая команда Е ЕААОРЕЕУЕЕ 1 СОТО ЕАРОН2 проверяет результат вы- 
полнения самой операции копирования в каталог О\ВАСКУР\, которая может за- 
вершиться ошибкой, например, из-за отсутствия свободного места на целевом 
носителе информации или из-за сбоя подключения сетевого носителя. 

Перед копированием файла сетевого репозитория, размещённого на сер- 
вере, надо останавливать работу сервера Ео$$1. Это требуется для того, чтобы в 
копию попали все завершённые транзакции и данные из буферов операционной 
системы. Копирование файла репозитория, с которым в этот момент работает 
сервер, чревато получением неполноценной копии. В следующих версиях Е0$5 
планируется реализовать механизм, позволяющий создавать корректные копии 
Гоз$-файлов на лету с помощью команды вида: 


Ео$$11 за1 "уасиим героз1еогу 1п6о 'ззримерз1Ее.раскКир'" -В ззрмер- 
$16е.Ео0$5511 


Но пока что это лишь планы разработчиков. А до их реализации следует 
соблюдать правильную процедуру резервного копирования. 


3.2. Восстановление информации из репозитория 


Предположим, что неприятность всё же случилась — файл сетевого репо- 
зитория оказался повреждённым, проблема не была своевременно обнаружена и 
распространилась на резервные копии. Что можно предпринять в этом случае? 

Во-первых, надо помнить о том, что регулярно синхронизируемые ло- 
кальные репозитории содержат большую часть информации, имеющейся в се- 
тевом репозитории. Возможно, наиболее простым решением станет размещение 
на сервере одного из таких локальных репозиториев, после чего потребуется 
вручную произвести его донастройку — завести учётные записи участников 
проекта и записать бесконтрольные файлы. 

Во-вторых, можно попытаться спасти информацию из повреждённого 
Го3$]-файла. Как неоднократно отмечалось, №ю0$51-файлы — это файлы в форма- 
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те базы данных ЗОГ ле, и для их обслуживания можно использовать любые ин- 
струменты, пригодные для работы с ЗОГе. Кроме того, саму программу $51 
можно запустить в режиме работы с базой данных репозитория на низком 
уровне. 

Допустим, при проверке оказалось, что на 117-м элементе обнаружено 
повреждение структуры базы данных: 


117/122 
ЗОГТТЕ_СОВВОРТ (11): Яабаразе соггкире1оп а® 11пе 68308 оЕ [с20а353364] 


Рафафазе еггог: БОТ егког (11,11: Чабабазе а1$зК 1таде 1$ тма1Еогщеа) 
\м211е кипп1па [ЗЕЪЕСТ сопбепЕ ЕВОМ Б1оь МНЕВЕ г19=:к1а АМР 517е>=0] 


Перед выполнением любых дальнейших действий надо в обязательном 
порядке создать резервную копию этого, пусть даже повреждённого, файла ре- 
позитория. Восстановительные мероприятия в условиях неопределённости не 
всегда приводят к успеху, а чтобы испытать другой метод восстановления, ис- 
ходная копия файла очень пригодится. 

Если веб-интерфейс репозитория ещё функционирует, то можно попы- 
таться узнать, что за элемент скрывается под таким номером. Для этого надо 
воспользоваться пунктом раскрывающегося меню [1$ о А|НасЕ (рис. 3.1). 


= О х 
© тре эпае-раде мебзйе: 5? Х + 


= С О Не защищено | #ю0551.5егмег:8081/ о! ха [= 


эитр!е зтае-раде меь$Ке / и огляиась пол 


РВ Ноте ТЛте!пе [Иез Вгапсвез 

® Ноте Раде е МН 

® Ее Вгомзег о |134 о ММК Радез 
о Гее-ме\и, Тгипк Свеск-тп о Кесег{асвуйу 
о Наемем о Запабох 
© НЕ адез Гог ТгипК о [151 оГА{асптеп{ 
о Ипуегзюопед Ейез е 109дт 

® Ргоес! Титейпе ® Керозйогу За 
© Асймцу Верой о Сойзюпз оп пазй ргейхез 
о Ре пате свапдез о 
о Роз о 1$ ог" Птемиагр" Спеск-пз 


\— 


114 а702091989 мик! "Разметка веб-страницы" 
115 667793672е мик "Оформление веб-страницы" 
— ЕН мик! "Макет рая разработки" 

6 505 ацасбтеп!-сопиго! Тог Макет.рпд 
119 6998901095 мик! "Оформление веб-страницы" 
120 аббЗе1е94{ мик! "Оформление веб-страницы" 


Рис. 3.1 
Просмотр списка элементов репозитория 
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В списке элементов под номером 117 значится иллюстрация Макет.рпд. Но 
по гиперссылке с её идентификатором 89е1576526 вместо детальной информа- 
ции об элементе выводится сообщение об ошибке (рис. 3.2). 


: =. О х 
@ тыЕ эпде-раде мебзйе: Вага Ж + 


/игбо/89е1576 


/ 


6491444 х @ 


— С О не защищено | Фо$$Й.зегуег 


тре зэтае-раде мерзКе / воз вечие= 


Год 


И 


Ноте Титейпе Е|е5 ВгапсВез 


Оомлюад 


Вааразе еггог: СЁ епог (11,11: да!абазе 41$К итаде 15 паНогтед) м/йе гиппа [ЗЕТЕСТ 
сощепЕ ЕВОМ Шо \/НЕБКЕ па=па АМО э!2е>=0] 


Рис. 3.2 
Вместо детальной информации об элементе отображается сообщение 
об ошибке базы данных 

Дальнейшие действия надо проводить из командной строки либо непо- 
средственно на сервере, где размещён файл сетевого репозитория, либо перепи- 
сав этот файл на локальный компьютер. Первое, что можно попробовать, — это 
запустить штатную процедуру перестроения базы данных репозитория с помо- 
щью команды: 


05511 гери11а -В звриерз1{е.Ео$$11 
В данном случае это не помогло, выполнение команды завершилось с 
ошибкой: 


89.9% сошртТефе... 
ЗОГТТЕ СОВВУРТ (11): Чдафаразе соггирЕ1оп аЕ 11пе 68996 оЕ [2Ес80еЕ16с] 


т 


Рафафазе еггог: СОТ егког (11,11: ЧабаБазе а1$зК 1таде 1$ тма1Еогпеа) 
\мр11е капп1па [ЗЕЩЕСТ сопеепЕ ЕВОМ Б1оЪ МНЕВЕ г19=:г1а АМО 517е>=0] 


В режиме низкоуровневой работы с базой данных можно выгрузить со- 
держимое Юю5$-файла в текстовый файл, представляющий собой последова- 
тельность команд ЗОГ, которые необходимо выполнить для создания базы дан- 
ных со всем еб содержимым с нуля. Для этого предназначена команда: 


Ео$5$11 $5а1 «„кесоуег -В ззримерз16е.Еоз$11 > ззриерз1фе.за1 


В случае успешного выполнения на экран эта команда ничего не выводит, 
но рядом с КЮюз3-файлом ззруммебзйеЮз$Й будет создан текстовый файл 
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ззрмебзйе.:0/. Срествами операционной системы переименуем повреждённый 
файл репозитория ззрмебзНе.Ю3$Й в ззрмебзНе ю$$й.раа, после чего воссоздадим 
структуру файла репозитория с помощью последовательности команд: 


05511 5491 -В з5риер51%е.Еоз5$11.Баа 
$49116е> «„ореп зэзрмерз1ее.Ео$$11 
$9116е> .кеаА ззрмерз1е.5а1 
$а116е> .аа1е 


Первая команда запускает режим низкоуровневой работы с базой данных. 
Поскольку этой команде необходимо указание имени файла №05$-репозитория, 
в параметре -К передаётся имя файла повреждённого репозитория, но можно, 
например, создать новый репозиторий и указать имя его №0$5П-файла. Вторая 
команда инициирует создание файла пустой базы данных с именем 
ззрмебзНе.Юю$31. Третья команда запускает выполнение ЗОГ-команд, содержа- 
щихся в текстовом файле эзрмерзйе.з4, который содержит инструкции по со- 
зданию №55$П-репозитория. Последняя команда предназначена для завершения 
работы с программой. 

В результате файл репозитория $зрмебзйе.Ю5$$1 будет создан заново. Снова 
выполним команду перестроения базы данных: 


Еоз$11 хера11а -В ззрмебз1Ее.Ео$$11 

На этот раз она завершается без ошибок, структура базы данных восста- 
новлена: 
100.0% сомр1еее... 

Но радоваться рано. Выполним команду проверки целостности репозито- 
рия: 
Ео$$11 сезЕ-1пседг1еу ззрмерз16е.Ео$$11 

Она выводит на экран следующее сообщение: 


мгопа разН оп акЕ1ЕасЕ 117 

Неправильная контрольная сумма элемента 117 

127 поп-рвапбом Ь1ор5 (ойЕ оЕ 127 Еофа1) спВесКкеЯ: 1 егкогв 
127 блоков (из 127 всего) проверено: 1 ошибка 

1ом-1еуе1 Чафафазе 1п6еах1еу-сВесКк: ок 


Низкоуровневая проверка целостности базы данных: ок 


Структура базы данных восстановлена, но чуда не произошло и повре- 
ждение 117-го элемента не исцелилось. Если теперь запустить сервер Ео$3] и 
через веб-интерфейс перейти на страничку с информацией о 117-м элементе ре- 
позитория с идентификатором 89е576526, то будет выведено его описание 
(рис. 3.3). Однако при выборе пункта дополнительного меню Оомпюа4 вместо 
макета веб-сайта отобразится чёрный квадрат. Судя по всему, файл Макет.рпа в 
репозитории безнадёжно повреждён. 
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= О х 
5итр/е зпоа!е-раде меб зе: Аи" Х + 
9'е-рад 


< (С ОФ Не защищено | 105$1.5егуег:8081/о/89е!576526491444 х @ 


эитр!е зтае-раде мер $Ке / длинах сомеге под 


= Ноте Ттете Ее; Вгапсвез 


Оомипюад Нех Оле Митьегз 


АГИНас+{ @ 89е15765269914447475а690а1320е06214570с8аа527002154ес956726Ь5а3: 


АКасбтепи "Макет.рпд" {0 \мК! раде [Макет для разработки] аддед Бу Мападег оп 2020-04-14 11:12:01 


(Ше 15 263361 Буе5$ оГЬтагу даа) 


Рис. 3.3 
Страница с описанием 117-го элемента репозитория 


В критической ситуации существует возможность выгрузить всё содер- 
жимое репозитория в виде отдельных файлов. Сначала создадим для них ката- 
лог а|Нас, после чего выполним команду: 


Ео$$11 АаесопзЕгасЕ --рх1уафе -В з5рмерз1Ее.Ео$$11 ах®1Еасе5$ 


В случае успеха эта команда сообщит: 


100.0% сошр1еее... 


В результате работы этой команды в каталоге айИас будут созданы под- 
каталоги 00, 01, 02, ..., а0, а1, ..., е, №, имена которых соответствуют первым 
двум шестнадцатеричным цифрам идентификаторов выгруженных элементов. 
В этих подкаталогах будут находиться файлы с именами, составленными из 
оставшихся цифр идентификаторов хранящихся в них элементов, начиная с тре- 
тьей. Например, проблемный 117-й элемент с идентификатором 89е576526 
должен оказаться в файле с именем е!57652699М..., который размещён в подка- 
талоге 89. И действительно, такой файл нашёлся, только он оказался нулевой 
длины — из-за повреждения система Ео$$1 не смогла его выгрузить правильно. 

Для выполнения обратной операции по сворачиванию выгруженных эле- 
ментов репозитория из каталога а|!Йас6 в файл базы данных геро.Ю5$$1 надо вы- 
полнить команду: 


Ео$$11 гесопзЕкасЕ геро.ЁЕо$$11 агЕ1Еас®з 


Эта команда выводит на экран сообщение: 


ВеаЧ1п9 Е11ез Егом а1гесбоку "ах®1Еасе5"... 

127 

Ви1191па ЕБе Гоз511 героз16оху... 

178.2% сошр1еее... 

рго]есе-1а: 1031Еа4921рЕрсаеаЁеЕ34е313Е8Е2а28933ЕеЗа 
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зегуег-14: ба8Е5а0р44'78595953а1 38аЕ9ар238а7265Ъа8а9 
аЯ9т1п-изег: РСОзег (1п161а1 раззмога 15 "а9\мКТигуБО") 


В результате будет создан файл нового №$$-репозитория геро.Ю$$1. Одна- 
ко много информации из исходного репозитория, например учётные записи 
пользователей, будет утрачено. 

Описанные примеры низкоуровневых манипуляций с №$$|-репозиторием 
приведены в большей степени для того, чтобы показать, что восстановить по- 
вреждённый файл репозитория Еоз$ в первозданном виде практически невоз- 
можно. Поэтому стоит уделять внимание правильному резервному копирова- 
нию сетевого репозитория, а в случае форс-мажора лучшим вариантом станет 
замещение сетевого репозитория одним из локальных с выполнением отсут- 
ствующих настроек. 


3.3. Обновление системы 


Интегрированная система Ео$5 — это динамично развивающийся проект. 
Актуальная на момент начала написания книги версия 2.10 к её завершению 
сменилась на 2.11. Каждая новая версия несёт в себе устранение обнаруженных 
ошибок, улучшение работы существующих механизмов и добавление новых 
функций. Поэтому у пользователей Еоз$ безусловно имеется интерес в под- 
держании своих инструментов в актуальном состоянии. 

Сложность перехода на новую версию заключается в том, что система 
Ео5$ двухкомпонентная — она состоит из исполняемого файла ю$$1, реализу- 
ющего всю логику работы, и хранилища информации — базы данных ЗОГ Те. 
Если обновление исполняемого файла не представляет трудности (его можно 
просто заменить новой версией, полученной с официального сайта), то о базе 
данных такого сказать нельзя. Недопустимо просто взять и переписать суще- 
ствующий файл репозитория — при этом пришлось бы начинать работу над 
проектом с самого начала. 

Не удивительно, что разработчики Е05$ включили механизм обновления 
структуры базы данных в исполняемый файл ю$$й. В результате правильная 
процедура обновления состоит из двух шагов: 

1) заменить исполняемый файл !ю$$1 (юЮз$1.ехе для \УЛпдо\$) новой верси- 
ей; 

2) обновить базы данных репозиториев с помощью команды 10$$Й а! 
герийа. 

Эти действия надо выполнить как на сервере Еоз$1, так и на индивиду- 
альных рабочих местах всех участников проекта. Команда 'ю$$1 а! гебий4 обнов- 
ляет структуры баз данных всех №ю$5-репозиториев, которые когда бы то ни 
было использовались на компьютере, где выполняется эта команда. Откуда 
Ео5$1 знает и помнит об этих репозиториях? 

Система Ео5$ незаметно ведёт реестр репозиториев, над которыми вы- 
полнялись операции, в файле %:ОСАЕГАРРОАТА%\ 10551, %АРРОАТА%\_+0$51 или 
%НОМЕРАТН%\_юЮ5$$1, если работа происходит в операционной системе 
УИп4до\з, либо в файле Ю$$Й домашнего каталога пользователя в случае других 
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операционных систем. Это даёт возможность выполнения однотипных опера- 
ций сразу над всеми репозиториями. 

Например, если планируется автономная работа без сетевого подключе- 
ния, пользователь может синхронизировать сразу все свои репозитории с серве- 
ром с помощью команды 10$$1 а! зупс. Бывает удобно также посмотреть все ещё 
не загруженные в репозитории изменения с помощью команды 10$$1 а! спапдез. 

Возвращаясь к вопросу обновления версии Е0$$1|, надо отметить, что пе- 
реход на единую версию системы, безусловно, желателен, но маловероятно воз- 
никновение каких-нибудь серьёзных проблем, если это не произойдёт едино- 
временно. Система Ео$5И имеет достаточно хорошо продуманную архитектуру, 
чтобы не допустить критического нарушения своей работы. 


3.4. Индивидуальная разработка 


В книге подробно рассмотрен пример использования системы Е0$$ в 
коллективной работе над проектом. Однако инструменты этой системы целесо- 
образно применять и в индивидуальной разработке. Если индивидуальная раз- 
работка ведётся с использованием сервера Е0о$5И, то можно последовательно 
следовать всем изложенным в книге рекомендациям, за тем исключением, что 
для работы достаточно одной учётной записи с максимальными полномочиями. 

В то же время при отказе от использования сервера эксплуатация инстру- 
ментов Ео$31 значительно упрощается с сохранением большей части функцио- 
нальности. В этом случае использование сетевого репозитория исключается, а 
локальные репозитории можно называть просто репозиториями без риска воз- 
никновения путаницы. Рассмотрим шаги, которые необходимо выполнить в та- 
ком варианте использования. 

Прежде всего систему Ео5$ необходимо установить на компьютере раз- 
работчика. О том, как это сделать, рассказано во второй главе этой книги. После 
этого можно создавать файл репозитория Е0$5Й и рабочий каталог проекта. 
Предположим, что планируется работа над проектом с кодовым названием 
Рго|ес+. 

В дальнейшем изложении предполагается, что работа осуществляется в 
операционной системе \Лпдо\з, поэтому в качестве разделителя элементов пу- 
ти к файлам и каталогам используется символ обратной наклонной черты (\). 
В среде других операционных систем надо использовать в качестве разделителя 
символ наклонной черты ()/). 

Для хранения файлов с репозиториями лучше всего создать отдельный ка- 
талог в корне раздела файловой системы или в домашнем каталоге пользовате- 
ля. Назовём этот каталог героз. Тогда потребуется выполнить следующую по- 
следовательность команд для создания каталога и файла нового репозитория 
ргоес!10$$1 в нём: 


пКка1к гкероз 
Ео3$11 1016 героз\рго]есе.Еоз$11 
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Рабочие каталоги проектов тоже лучше размещать внутри общего катало- 
га, предназначенного специально для этой цели. Чтобы создать общий каталог 
могКк и рабочий каталог проекта рго]ес{ в нём, надо выполнить команды: 


шкатк мокк 
шка1к могк\ргодесе 


Теперь можно установить связь между рабочим каталогом и соответству- 
ющим ему репозиторием. Для этого надо выполнить следующие команды: 


са моккК\ргодесе 
Еоз$11 ореп ..\..\хероз\ркодесе. Ео5$11 


На этом подготовку к работе над проектом Ргоес! можно считать завер- 
шённой. Основными элементами созданной структуры стали: 

® файл репозитория героз\рго]ес!.ю$$й; 

® файл с информацией о рабочем каталоге и соответствующем ему репо- 
зитории могК\ргоес\_РОЗЗШ_ (или могК\ргоес\.скош, если операционная си- 
стема — не \УЛп4до\$). 

С этого момента можно начинать работу над проектом. Чтобы система 
контроля версий начала отслеживание изменений в файлах с исходными тек- 
стами проекта, их надо добавить в список Е0$51] с помощью команды: 


Еозз11 ааа СписокФайлов 

Запись моментального снимка рабочего каталога в репозиторий Е0$5П 
производится с помощью команды: 
Ео$$11 сопи1е -м "ОписаниеИзменений" 

Откат содержимого рабочего каталога к одному из предыдущих состояний 
может быть выполнен с помощью команды: 
Еоз$511 срескойЕ ТочкаСохранения 

Даже при индивидуальной работе над проектом не следует игнорировать 
ВОЗМОЖНОСТЬ параллельной разработки в нескольких ветвях. Чтобы создать от- 


ветвление от одной из точек сохранения, имеющихся в репозитории, и пере- 
ключить на неё рабочий каталог, надо выполнить команды: 


Еоз$11 Юкапсб пем НазваниеВетви 
Еоз$511 срескоце НазваниеВетви ТочкаСохранения 
Для вливания наработок, выполненных вВ отдельной ветви проекта, в ос- 
новную ветвь, которая называется {гипК, надо выполнить команды: 
Еозз11 сБескойе Егапк 


Еоз$11 шегае НазваниеВетви 


Подробно о командах работы с репозиторием можно прочитать в четвёр- 
той главе. Управлять репозиторием и изучать шкалу времени проекта удобнее 
всего через веб-интерфейс. Быстро получить к нему доступ можно, если в рабо- 
чем каталоге проекта выполнить команду: 


Ео$$11 я1 
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В контексте веб-интерфейса следует упомянуть, что индивидуальному 
разработчику не стоит отказываться от возможностей работы с заявками и до- 
кументирования проекта, которые описаны в пятой и седьмой главах соответ- 
ственно. Систему работы с заявками на доработку при индивидуальном исполь- 
зовании Е0$5П можно превратить в список задач, подлежащих выполнению 
(© 4о 150. 

Важным аспектом в индивидуальной работе над проектами является ор- 
ганизация регулярного резервного копирования файлов репозиториев (которые 
в рассматриваемом примере хранятся в каталоге героз) на сменные носители 
информации или в сетевое файловое хранилище, ведь естественное дублирова- 
ние истории изменений в локальные репозитории участников проекта через се- 
тевой репозиторий при таком варианте использования не производится. Перед 
выполнением копирования надо проверять целостность структуры репозитория 
с помощью команды: 


Ео$$11 Еезе-1пседг1Еу ргко]есе.Ео$$11 


Таким образом, система Ео$$1, предоставляющая богатые возможности 
при совместной работе над проектами, может оказаться полезной в повышении 
качества и ДИСЦИПЛИНЫ индивидуальной разработки. 
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ПРИЛОЖЕНИЯ 


П.1. Глоссарий 


Локальный репозиторий — файл с рекомендованным расширением .№о$$1, 
имеющий структуру базы данных ЗОГЩе, размещённый на компьютере, где ве- 
дётся работа над проектом и находится рабочий каталог проекта. Предназначен 
для хранения моментальных снимков рабочего каталога проекта. Может содер- 
жать привязку к сетевому репозиторию. 

Сетевой репозиторий — файл с рекомендованным расширением „$1, 
имеющий структуру базы данных ЗОГ\е, размещённый на сервере компьютер- 
ной сети. Предназначен для синхронизации локальных репозиториев участни- 
ков проекта. 

Рабочий каталог — каталог (папка), содержащий файлы, которыми 
управляет система контроля версий. В рабочем каталоге находится служебный 
файл РО5$Ш. (или .Ё]сКои0, имеющий структуру базы данных ЗОГ Ще и со- 
держащий привязку к локальному репозиторию. 

сйеск-т — загрузка моментального снимка файлов проекта из рабочего 
каталога в репозиторий, создание в репозитории точки сохранения; результат 
такой загрузки. 

сйеск-ои! — выгрузка из репозитория в рабочий каталог файлов проекта в 
том состоянии, в котором они находились на момент создания точки сохране- 
ния; результат такой выгрузки. 

сотти — операция по загрузке моментального снимка рабочего каталога 
в репозиторий; результат такой загрузки, точка сохранения проекта, то же, что 
сресК-ш. 

ризй — отправка изменений, зарегистрированных в локальном репозито- 
рии, в сетевой репозиторий (в режиме ашюозупс, который включён в Е0$5И по 
умолчанию, выполняется автоматически при операциях с локальным репозито- 
рием). 

ри! — получение изменений, зарегистрированных в сетевом репозито- 
рии, в локальный репозиторий (в режиме ащозупс, который включён в Ео$51 по 
умолчанию, выполняется автоматически при операциях с локальным репозито- 
рием). 

Бтапсй — ветвь разработки, состоящая из последовательности сфеск-т. 
Основная ветвь создаётся автоматически и называется гипк, но по желанию 
разработчика могут быть созданы дополнительные параллельные ветви для те- 
стирования или развития определённых версий разрабатываемого проекта. 

ютк — нежелательное разветвление линии разработки, произошедшее из- 
за неустранимого конфликта внесённых в проект изменений; ветвь разработки 
(БгапсВ), возникшая в результате такого события. 
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П.2. Основные команды Ёо$$1 


П.2.1. Команды общего назначения 


оз Бер Команда — вывести на экран подсказку по использованию ко- 
манды Команда. 

10531 аП 15$ — вывести список локальных репозиториев. 

0551 аП ризБ — выполнить команду ризВ для всех известных локальных 
репозиториев. 

Гю$$Й аП ри| — выполнить команду ри] для всех известных локальных 
репозиториев. 

Го5$1 аП зупс — выполнить синхронизацию всех локальных репозиториев 
с сетевыми. 

Гоз$Й аП теб — обновление версий всех известных локальных репози- 
ториев (рекомендуется после обновления исполняемого файла Е0$51). 


П.2.2. Команды над файлом репозитория 


05$ ши --адтт-и5ег Владелец ФайлРепозитория — создать новый репо- 
зиторий в файле ФайлРепозитория и назначить его владельцем пользователя с 
именем Владелец. 

Ю55П ш ФайлРепозитория — открыть в веб-браузере страницу веб- 
интерфейса для репозитория ФайлРепозитория от имени его владельца. 

Го5$1 зегуег -Р Порт ФайлРепозитория — предоставить сетевой доступ к 
репозиторию ФайлРепозитория и ожидать сетевых подключений на ТСР-порту 
с номером Порт. 

05$ сюпе ОВКГ ФайлРепозитория — создать локальную копию сетевого 
репозитория, доступного по адресу ОВГ, в файле ФайлРепозитория. 

0551 ореп ФайлРепозитория — назначить текущий каталог рабочим ката- 
логом для репозитория, находящегося в файле ФайлРепозитория, и выгрузить в 
него последний моментальный снимок основной ветви разработки. 

0551 гетое -В ФайлРепозитория ОВГ, — установить для локального ре- 
позитория в файле ФайлРепозитория привязку к сетевому репозиторию, до- 
ступному по адресу ОВГ (можно использовать для локального репозитория при 
смене пароля пользователя в сетевом репозитории). 


П.2.3. Команды рабочего каталога 


[0551 зе тя5 сПЕ-2106 "*" — не предупреждать о наличии в файлах рабоче- 
го каталога двухбайтовых символов перевода строки СВ/ГЕ. 

[0551 аз — показать состояние рабочего каталога. 

[05$ свапоез — показать отличия рабочего каталога от моментального 
снимка. 

[055$ ехфаз — показать файлы, находящиеся в рабочем каталоге, но не 
входящие в список файлов, управляемых системой контроля версий. 

0531 АНР — показать детальные различия между моментальным снимком 
в репозитории и текущим состоянием рабочего каталога. 


271 


0531 ада ИмяФайла — внести файл ИмяФайла в список файлов, управля- 
емых системой контроля версий. 

053! пп ИмяФайла — исключить файл ИмяФайла из списка файлов, 
управляемых системой контроля версий. 

Ю$$П ту --Вага СписокФайлов Каталог — переместить файлы, перечис- 
ленные через пробел в списке СписокФайлов, в каталог Каталог, как в системе 
контроля версий, так и в файловой системе. 

0551 сошти -т "Описание" — Загрузить моментальный снимок файлов 
рабочего каталога в репозиторий с комментарием Описание (создать в репози- 
тории точку сохранения — сБеск-11). 

053 атепа Идентификатор -т "Описание" — заменить описание точки 
сохранения Идентификатор на новое Описание. 

Гозз сБесКой{ Идентификатор — привести содержимое рабочего каталога 
в соответствие с точкой сохранения, хранящейся в репозитории и имеющей 
идентификатор Идентификатор (выгрузить из репозитория в рабочий каталог 
моментальный снимок сВеск-т с идентификатором Идентификатор). 

0551 ирдае — привести файлы проекта, находящиеся в рабочем каталоге, 
в соответствие с содержимым репозитория с сохранением внесённых в них из- 
менений. 

0551 разБ — отправить изменения локального репозитория в сетевой ре- 
позиторий (в режиме автоматической синхронизации, установленном по умол- 
чанию, выполняется автоматически). 

0551 ри! — получить изменения сетевого репозитория в локальный репо- 
зиторий (в режиме автоматической синхронизации, установленном по умолча- 
нию, выполняется автоматически). 

Г0$$1 зупс — обменяться изменениями между локальным и сетевым репо- 
зиторием (в режиме автоматической синхронизации, установленном по умолча- 
нию, выполняется автоматически). 

05$ ип4о — отменить последнюю команду. 

10551 гедо — повторить выполнение отменённой команды. 


П.2.4. Команды над ветвями 


Го5$И Бгапсн — вывести список имеющихся в репозитории ветвей разра- 
ботки. 

Го$$1 Бгапсв пе\м "Название" Идентификатор — создать в репозитории но- 
вую ветвь разработки с названием Название, взяв за её основу моментальный 
снимок, соответствующий точке сохранения Идентификатор. 

оз сБесКои{ "Название" — переключить рабочий каталог на ветвь 
Название. 

05$ шегое Идентификатор — выполнить слияние — наложение момен- 
тального снимка из точки сохранения Идентификатор на текущее состояние. 

[0551 Теауез — вывести список последних точек сохранения на активных 
ветвях разработки. 
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П.2.5. Команды над ярлыками 


10551 ‘аз 1$ — вывести список назначенных ярлыков. 

[0551 ‘ас а44 --ргоразайе "Название" Идентификатор — назначить распро- 
страняющийся ярлык Название точке сохранения с идентификатором Иденти- 
фикатор. 

0531 {ас Ипа "Название" — показать точки сохранения, отмеченные яр- 
лыком Название. 

[05$ {ас сапсе| "Название" Идентификатор — прекратить распростране- 
ние ярлыка Название в точке сохранения Идентификатор. 


П.2.6. Команды работы с базой данных 


0551 за! 4аез$ -В ФайлРепозитория — вывести список таблиц базы дан- 
ных репозитория. 

105$ 541 "ЗЕГЕСТ * ЕКОМ герозцогу.изег;" -В. ФайлРепозитория — выве- 
сти записи таблицы герозИогу.изег базы данных репозитория. 


П.3. Специальные файлы Ро$$! 


%Г.ОСАГАРРРАТА%\_з51 или -/.1055П — содержит местонахождение 
всех ЕО$5П.-репозиториев пользователя. Используется командой №551 а||, ко- 
торая полезна при выполнении синхронизации перед переходом в автономный 
режим разработки (№55 аП ри!) и после возврата в сетевой режим (Ю5$1 аП 
разв). 

_2О0$$5П. или .ЁсКоч{ — находится в рабочем каталоге проекта и содер- 
жит информацию: 

® о привязке рабочего каталога к локальному репозиторию; 

® о точке сохранения в репозитории, которая явилась основой для файлов 
рабочего каталога; 

® об изменениях в составе файлов рабочего каталога, которые ещё не за- 
гружены в репозиторий. 


П.4. Сообщения об ошибках Ео$$й 


сиггеп ашесюгу 1$ поё уф ап ореп сВесКой{ — текущий каталог не явля- 
ется рабочим каталогом проекта; не найден файл _ЕО$5П._ или .ЕсВКочь, со- 
держащий привязку к локальному репозиторию проекта. 

Елог: 1осш ЁаЙе — ошибка авторизации в системе Ео$$1; неправильно 
указано имя пользователя или его пароль. 

Еггог: по{ аафог7е4 © \тце — пользователь не имеет права на запись в 
сетевой репозиторий; пользователю необходимо предоставить группу разреше- 
ний Оеуе]юорег (код У) или отдельное разрешение СВеск-Ш (код 1). 

поЕ Гюип4: тапк — в репозитории не обнаружена основная ветвь под 
названием гипк; возможно, основная ветвь была переименована. 
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П.5. Основные команды операционных систем 


Действие УУш9дом5 ОМХ и Ипах 

Просмотреть содержимое каталога ат ИмяКаталога 1$ ИмяКаталога 
Создать каталог шкаи ИмяКаталога 
Сменить текущий каталог с4 ИмяКаталога 
Удалить пустой каталог гиди ИмяКаталога 
Копировать файл сору Откуда Куда ср Откуда Куда 
Переместить файл шоуе Откуда Куда шу Откуда Куда 
Удалить файл де! ИмяФайла гп ИмяФайла 

Примечания: 


® каталог предыдущего уровня обозначается двумя точками ..; 

® в именах файлов могут использоваться подстановочные символы 
«звёздочка» (* — заменяет собой любое количество фактических символов) и 
«вопросительный знак» (? — заменяет собой ни одного или один символ); 

® в качестве разделителя имён в длинном пути к каталогу или файлу в 
операционной системе \УЛп4о\з используется символ обратной наклонной чер- 
ты \, а в операционных системах Чшх и Глпих — символ прямой наклонной 
черты /; 

® путь от корня файловой системы должен начинаться с символа- 
разделителя, о котором сказано в предыдущем пункте. В противном случае путь 
отсчитывается от текущего каталога. 


П.6. Описание учебного примера 


Состав файлов учебного примера: 

® шаех.Вит! — текстовый файл в кодировке ОТЕ-8, содержащий НТМГ- 
код содержимого веб-страницы; 

® Ш4ех.с$5 — текстовый файл в кодировке ОТЕ-8, содержащий С55-код 
стилевого оформления веб-страницы; 

® ппасез/ВагОКопа.с1{ — изображение логотипа размером 144х144 пиксе- 
лей, которое размещается в правом верхнем углу веб-страницы; 

® Ппасе5/Аето.ре — изображение иллюстрации информационного блока 
размером 320х240 пикселей, которое размещается сбоку от содержимого ин- 
формационного блока; 

® Ппасе$/626Коп4.2 — изображение размером 2х8 пикселей жёлтого 
цвета, которое служит элементом для построения линий подчёркивания заго- 
ловков информационных блоков. 


Листинг файла таех.йт! 


<!аосбуре ВЕп1> 
<рем1 1апад="ги"> 
<реа@а> 
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<Е1Е1е>Сотрапу сага</Е1Е1е> 

<пеба срагхзеф="аеЕ-8"> 

<11пК ВкеЕ="1раех.сзз" ге1="зсу1езреее" фуре="кехе/сзз"> 
</пеаа> 

<Боау> 

<Беааек> 

<па\у> 

<01> 

<11><а ргеЕ="#зесЕ1">Сопрапу</а></11> 
<11><а ВгеЕ="#зес®2">бесЕ1оп 1</а></11> 
<11><а ВгеЕ="#зес®3">бесЕ1оп 2</а></11> 
<11><а пгеЕ="#зес&4">5есЕ1оп 3</а></11> 
</и1> 

</пау> 

<а1у> 

Тогеп<Ьг> 

1рзим Ао1ог<рг> 

$51Е амее<Юк> 

</а1у> 

</пеааег> 

<па1п> 

<зесЕ1оп> 

<Беааек> 

<в2><а 1а="зесЕ1">Сопрапу</а></62> 
<1иа згс="1тадез/аето.)рд" а1&="аемо"> 
</веа4ег> 

<91у><!-- ЗАПОЛНИТЕЛЬ --></91\> 

<Бк> 

</зесЕ1оп> 

<зесЕ1оп> 

<Беааек> 

<в2><а 149="зес®2">5бесЕ1оп 1</а></62> 
<1иа згс="1тадез/аепо.)ра" а1&="аемо"> 
</веа4ег> 

<91у><!-- ЗАПОЛНИТЕЛЬ --></91у> 

<Бк> 

</зесЕ1оп> 

<зесЕ1оп> 

<Беааек> 

<в2><а 14="зес®3">5бесЕ1оп 2</а></В2> 
<1иа згс="1тадез/аепто.)ра" а1Е="аемо"> 
</веа4ег> 

<91у><!-- ЗАПОЛНИТЕЛЬ --></91\> 

<Бк> 

</зесЕ1оп> 

<зесЕ1оп> 

<Беааек> 

<в2><а 19="зесЕ4">5есЕ1оп 3</а></62> 
<1иа згс="1тадез/аепо.)рд" а1&="аемо"> 
</веа4ег> 

<91у><!-- ЗАПОЛНИТЕЛЬ --></91\> 

<Бк> 

</зесЕ1оп> 
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</та1п> 

<Еоофег> 

<р>Сотрапу сопфасез</р> 
<р><зрап>ЕБ</зрап> <зрап>Ъе</зрап></р> 
<р>Соруг1а6Е © Сомрапу, 2020.</р> 
</Еоофег> 

</Боау> 


Примечание. Вместо комментариев <-- ЗАПОЛНИТЕЛЬ --> следует вставить 


текст: Гогет рзит 4оог эй атеф, сопзецеиг ааризста ей, зе4 до ешзточ {етрог т- 
саит: и Тарбоге е{ до!оге тадпа айдца. \1 епт аЧ тит уетат, аи! поза ехегсйа- 
{оп иЙатсо |абой$ п! { айашр ех еа соттодо сопзедиа{. Ош$ аще ниге аоог т гер- 
гепепаег( т уошрае уей еззе сШит до!оге еи аа пиЙа рапаиг. Ехсереиг эт ос- 
саеса{ сирааа{ поп ргоет, зип м сшра аш ойса дезегит то!й апит 14 ез{ |абогит. 


Листинг файла таех.с$5 


* {пага1п: 0; рааа1та: 0} 
роау {ЕопЕ: погма1 погма1 погща1 100% запз-зег1 ЕЁ} 
реаЧек, Гоофек {пах-м1аер: 1000рх; пагд1п: ачбо; рааа1пта: 4ех 29%; 
фехЕ-а119п: сепеег} 
реааег { 
РаскакоипЯ: дгкау; 
Баскакойпа: 11пеаг-дгаЧ1еп® (о бор,#р00, #ЕЕЁ) ; 
} 
реааек а1у { 
БВезаВеЕ: 160рх; 
пага1п-Кор: 2ех; 
рааа1па-1еЕф: 20$; 
Баскакоппа-1таде: ик] ("1тадез/вахгоката.а1Е"); 
раскКакоппа-роз1Е1оп: 80% сепЕег; 
Раскагкоипа-гереа®: по-гкереа{; 
фехЕ-а11а91: 1еЕС; 
Еопе: погма1 погма1 Бо1а 1.8ем запз-зек1 Е 


} 

па1п {пах-и1абр: 1000рх; пага1п: аиф®о; рааа1та: 4ех 2%; Баск- 

агоппа-со1ог: Е 

а {со1ог: Б1асКкК; фехе-аесога®1оп: попе} 

ГеаЧек пау { 
ЕопЕ-мезаре: рота; 
ЕопЕ-Чаесога%*1оп: ипаегсоге 


} 
Беааег пау 91 11 а:Боуег {ЕехЕ-аесога®1от: ппаек11пе} 
РеаЧдекг пау и1 11 {пага1п-1еЕЕ: 2ещ; 113з6-з6у1е-буре: попе; @15$ 
р1ау: 1п11пе} 
реа4етк пау 11 11:Е1:756-ср11А {пагд1п-г1а9ре: беп} 
зесЕ1ол Беааег [2 { 
Раскагоипа-1паде: иг1 ("1падчез/б2ЬКапа.а1Е"); 
раскакоппа-ро$1Е1оп: Боевой; 
Раскагкоипа-гереа®: гереа®-х 


} 
зесЕ1оп {тага1п-бор: 2ех; рааа1па: 1ех 1ем; СехЕ-а1191п: ]а5Е1ЕуУ} 
зесЕ1оп {тага1п-1еЕЁ: 5%; мага1п-г1аре: 5%} 
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зесе1о 
зесе1о 
зесе1о 
зесе1о 
зесе1о 
1.4ещ} 
зесе1о 
зесе1о 
зесе1о 
Еообег 
фошм, #0 
Еообег 
зег1Ё} 


{ 


:П 
:П 


рэ 


оз») 
о») 


[э) 
№) 


Ор, 
р 


и1п-резаре: 200рх; Баскакоцпа: мВ1ее} 


пеаЧег {раскКагоппа: попе; пага1п-БоЕбот: 1ех} 
Беааег 1тмач {тага1п-роЕеом: 1ех; м1таёВ: 44$} 


Ер-ср11а (оаа) ВБеааек №2 {Е1оае: 1еЕф} 
Ер-ср11а (оаа) Беааег 1пач {Е1оа®: х1арЕ; пагд1п-1еЕЕ: 


Ер-ср11а (еуеп) Беааек №2 {Е1оа®: г190е} 

Ер-ср11а (еуеп) 1ма {Е1оае: 1еЕЕЁ; мака1п-г1оаре: 1.4ет} 

г {с1еахг: Боёр; Богаег: Орх $011а} 

{ретаье: 140рх; Баскакоппа: 11пеах-дгаЧ1еп® (Фо БоЕ- 
ЕЕР) } 

{пагд1п-бор: 2ех; Еопе: 1%а11с погма1 Бо1а 0.8ем запз- 
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